W3cubDocs

/GTK 4.0

GtkAppChooserDialog

GtkAppChooserDialog — An application chooser dialog

Functions

GtkWidget * gtk_app_chooser_dialog_new ()
GtkWidget * gtk_app_chooser_dialog_new_for_content_type ()
GtkWidget * gtk_app_chooser_dialog_get_widget ()
void gtk_app_chooser_dialog_set_heading ()
const char * gtk_app_chooser_dialog_get_heading ()

Properties

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

Types and Values

GtkAppChooserDialog

Object Hierarchy

    GObject
    ╰── GInitiallyUnowned
        ╰── GtkWidget
            ╰── GtkWindow
                ╰── GtkDialog
                    ╰── GtkAppChooserDialog

Implemented Interfaces

GtkAppChooserDialog implements GtkAccessible, GtkBuildable, GtkConstraintTarget, GtkNative, GtkShortcutManager, GtkRoot and GtkAppChooser.

Includes

#include <gtk/gtk.h>

Description

GtkAppChooserDialog shows a GtkAppChooserWidget inside a GtkDialog.

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

To set the heading that is shown above the GtkAppChooserWidget, use gtk_app_chooser_dialog_set_heading().

Functions

gtk_app_chooser_dialog_new ()

GtkWidget *
gtk_app_chooser_dialog_new (GtkWindow *parent,
                            GtkDialogFlags flags,
                            GFile *file);

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

Parameters

parent

a GtkWindow, or NULL.

[allow-none]

flags

flags for this dialog

file

a GFile

Returns

a newly created GtkAppChooserDialog

gtk_app_chooser_dialog_new_for_content_type ()

GtkWidget *
gtk_app_chooser_dialog_new_for_content_type
                               (GtkWindow *parent,
                                GtkDialogFlags flags,
                                const char *content_type);

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

Parameters

parent

a GtkWindow, or NULL.

[allow-none]

flags

flags for this dialog

content_type

a content type string

Returns

a newly created GtkAppChooserDialog

gtk_app_chooser_dialog_get_widget ()

GtkWidget *
gtk_app_chooser_dialog_get_widget (GtkAppChooserDialog *self);

Returns the GtkAppChooserWidget of this dialog.

Parameters

self

a GtkAppChooserDialog

Returns

the GtkAppChooserWidget of self .

[transfer none]

gtk_app_chooser_dialog_set_heading ()

void
gtk_app_chooser_dialog_set_heading (GtkAppChooserDialog *self,
                                    const char *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 GtkAppChooserDialog

heading

a string containing Pango markup

gtk_app_chooser_dialog_get_heading ()

const char *
gtk_app_chooser_dialog_get_heading (GtkAppChooserDialog *self);

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

Parameters

self

a GtkAppChooserDialog

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

GtkAppChooserDialog

typedef struct _GtkAppChooserDialog GtkAppChooserDialog;

Property Details

The “gfile” property

  “gfile”                    GFile *

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

Owner: GtkAppChooserDialog

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: GtkAppChooserDialog

Flags: Read / Write

Default value: NULL

© 2005–2020 The GNOME Project
Licensed under the GNU Lesser General Public License version 2.1 or later.
https://developer.gnome.org/gtk4/4.0/GtkAppChooserDialog.html