CtkAppChooserDialog: CTK+ 3 Reference Manual

CtkAppChooserDialog

CtkAppChooserDialog — An application chooser dialog

Functions

CtkWidget *	ctk_app_chooser_dialog_new ()
CtkWidget *	ctk_app_chooser_dialog_new_for_content_type ()
CtkWidget *	ctk_app_chooser_dialog_get_widget ()
void	ctk_app_chooser_dialog_set_heading ()
const gchar *	ctk_app_chooser_dialog_get_heading ()

Properties

GFile *	gfile	Read / Write / Construct Only
char *	heading	Read / Write

Types and Values

struct	CtkAppChooserDialog
struct	CtkAppChooserDialogClass

Object Hierarchy

    GObject
    ╰── GInitiallyUnowned
        ╰── CtkWidget
            ╰── CtkContainer
                ╰── CtkBin
                    ╰── CtkWindow
                        ╰── CtkDialog
                            ╰── CtkAppChooserDialog

Implemented Interfaces

CtkAppChooserDialog implements AtkImplementorIface, CtkBuildable and CtkAppChooser.

Includes

#include <ctk/ctk.h>

Description

CtkAppChooserDialog shows a CtkAppChooserWidget inside a CtkDialog.

Note that CtkAppChooserDialog does not have any interesting methods of its own. Instead, you should get the embedded CtkAppChooserWidget using ctk_app_chooser_dialog_get_widget() and call its methods if the generic CtkAppChooser interface is not sufficient for your needs.

To set the heading that is shown above the CtkAppChooserWidget, use ctk_app_chooser_dialog_set_heading().

Functions

ctk_app_chooser_dialog_new ()

CtkWidget *
ctk_app_chooser_dialog_new (CtkWindow *parent,
                            CtkDialogFlags flags,
                            GFile *file);

Creates a new CtkAppChooserDialog for the provided GFile, to allow the user to select an application for it.

Parameters

parent	a CtkWindow, or `NULL`.	[allow-none]
flags	flags for this dialog
file	a GFile

Returns

a newly created CtkAppChooserDialog

Since: 3.0

ctk_app_chooser_dialog_new_for_content_type ()

CtkWidget *
ctk_app_chooser_dialog_new_for_content_type
                               (CtkWindow *parent,
                                CtkDialogFlags flags,
                                const gchar *content_type);

Creates a new CtkAppChooserDialog for the provided content type, to allow the user to select an application for it.

Parameters

parent	a CtkWindow, or `NULL`.	[allow-none]
flags	flags for this dialog
content_type	a content type string

Returns

a newly created CtkAppChooserDialog

Since: 3.0

ctk_app_chooser_dialog_get_widget ()

CtkWidget *
ctk_app_chooser_dialog_get_widget (CtkAppChooserDialog *self);

Returns the CtkAppChooserWidget of this dialog.

Parameters

self

a CtkAppChooserDialog

Returns

the CtkAppChooserWidget of self .

[transfer none]

Since: 3.0

ctk_app_chooser_dialog_set_heading ()

void
ctk_app_chooser_dialog_set_heading (CtkAppChooserDialog *self,
                                    const gchar *heading);

Sets the text to display at the top of the dialog. If the heading is not set, the dialog displays a default text.

Parameters

self	a CtkAppChooserDialog
heading	a string containing Pango markup

ctk_app_chooser_dialog_get_heading ()

const gchar *
ctk_app_chooser_dialog_get_heading (CtkAppChooserDialog *self);

Returns the text to display at the top of the dialog.

Parameters

self

a CtkAppChooserDialog

Returns

the text to display at the top of the dialog, or NULL, in which case a default text is displayed.

[nullable]

Types and Values

struct CtkAppChooserDialog

struct CtkAppChooserDialog;

struct CtkAppChooserDialogClass

struct CtkAppChooserDialogClass {
  CtkDialogClass parent_class;
};

Members

Property Details

The `“gfile”` property

  “gfile”                    GFile *

The GFile used by the CtkAppChooserDialog. The dialog's CtkAppChooserWidget content type will be guessed from the file, if present.

Owner: CtkAppChooserDialog

Flags: Read / Write / Construct Only

The `“heading”` property

  “heading”                  char *

The text to show at the top of the dialog. The string may contain Pango markup.

Owner: CtkAppChooserDialog

Flags: Read / Write

Default value: NULL