![]() |
![]() |
![]() |
GTK+ 3 Reference Manual | ![]() |
---|---|---|---|---|
Top | Description |
#include <gtk/gtk.h> GtkAppChooserButton; GtkWidget * gtk_app_chooser_button_new (const gchar *content_type
); void gtk_app_chooser_button_append_custom_item (GtkAppChooserButton *self
,const gchar *name
,const gchar *label
,GIcon *icon
); void gtk_app_chooser_button_append_separator (GtkAppChooserButton *self
); void gtk_app_chooser_button_set_active_custom_item (GtkAppChooserButton *self
,const gchar *name
); gboolean gtk_app_chooser_button_get_show_dialog_item (GtkAppChooserButton *self
); void gtk_app_chooser_button_set_show_dialog_item (GtkAppChooserButton *self
,gboolean setting
); const gchar * gtk_app_chooser_button_get_heading (GtkAppChooserButton *self
); void gtk_app_chooser_button_set_heading (GtkAppChooserButton *self
,const gchar *heading
);
The GtkAppChooserButton is a widget that lets the user select an application. It implements the GtkAppChooser interface.
GtkWidget * gtk_app_chooser_button_new (const gchar *content_type
);
Creates a new GtkAppChooserButton for applications that can handle content of the given type.
|
the content type to show applications for |
Returns : |
a newly created GtkAppChooserButton |
Since 3.0
void gtk_app_chooser_button_append_custom_item (GtkAppChooserButton *self
,const gchar *name
,const gchar *label
,GIcon *icon
);
Appends a custom item to the list of applications that is shown
in the popup; the item name must be unique per-widget.
Clients can use the provided name as a detail for the ::custom-item-activated
signal, to add a callback for the activation of a particular
custom item in the list.
See also gtk_app_chooser_button_append_separator()
.
|
a GtkAppChooserButton |
|
the name of the custom item |
|
the label for the custom item |
|
the icon for the custom item |
Since 3.0
void gtk_app_chooser_button_append_separator
(GtkAppChooserButton *self
);
Appends a separator to the list of applications that is shown in the popup.
|
a GtkAppChooserButton |
Since 3.0
void gtk_app_chooser_button_set_active_custom_item (GtkAppChooserButton *self
,const gchar *name
);
Selects a custom item previously added with
gtk_app_chooser_button_append_custom_item()
.
Use gtk_app_chooser_refresh()
to bring the selection
to its initial state.
|
a GtkAppChooserButton |
|
the name of the custom item |
Since 3.0
gboolean gtk_app_chooser_button_get_show_dialog_item
(GtkAppChooserButton *self
);
Returns the current value of the "show-dialog-item" property.
|
a GtkAppChooserButton |
Returns : |
the value of "show-dialog-item" |
Since 3.0
void gtk_app_chooser_button_set_show_dialog_item (GtkAppChooserButton *self
,gboolean setting
);
Sets whether the dropdown menu of this button should show an entry to trigger a GtkAppChooserDialog.
|
a GtkAppChooserButton |
|
the new value for "show-dialog-item" |
Since 3.0
const gchar * gtk_app_chooser_button_get_heading (GtkAppChooserButton *self
);
Returns the text to display at the top of the dialog.
|
a GtkAppChooserButton |
Returns : |
the text to display at the top of the dialog, or NULL , in which
case a default text is displayed
|
void gtk_app_chooser_button_set_heading (GtkAppChooserButton *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.
|
a GtkAppChooserButton |
|
a string containing Pango markup |