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