|
gtkmm 3.1.18
|
A button to launch an application chooser dialog. More...


Public Member Functions | |
| virtual | ~AppChooserButton () |
| GtkAppChooserButton* | gobj () |
| Provides access to the underlying C GtkObject. | |
| const GtkAppChooserButton* | gobj () const |
| Provides access to the underlying C GtkObject. | |
| AppChooserButton (const Glib::ustring& content_type) | |
| Creates a new app-chooser button for applications that can handle content of the given type. | |
| void | append_separator () |
| Appends a separator to the list of applications that is shown in the popup. | |
| void | append_custom_item (const Glib::ustring& name, const Glib::ustring& label, const Glib::RefPtr< Gio::Icon >& icon) |
| Appends a custom item to the list of applications that is shown in the popup; the item name must be unique per-widget. | |
| void | set_active_custom_item (const Glib::ustring& name) |
| Selects a custom item previously added with append_custom_item(). | |
| void | set_show_dialog_item (bool setting=true) |
| Sets whether the dropdown menu of this button should show an entry to trigger a Gtk::AppChooserDialog. | |
| bool | get_show_dialog_item () const |
| Returns the current value of the Gtk::AppChooserButton:show-dialog-item property. | |
| void | set_heading (const Glib::ustring& heading) |
| Sets the text to display at the top of the dialog. | |
| Glib::ustring | get_heading () const |
| Returns the text to display at the top of the dialog. | |
| Glib::SignalProxy1< void, const Glib::ustring& > | signal_custom_item_activated () |
| Glib::PropertyProxy< bool > | property_show_dialog_item () |
| Whether the combobox should include an item that triggers a GtkAppChooserDialog. | |
| Glib::PropertyProxy_ReadOnly < bool > | property_show_dialog_item () const |
| Whether the combobox should include an item that triggers a GtkAppChooserDialog. | |
| Glib::PropertyProxy < Glib::ustring > | property_heading () |
| The text to show at the top of the dialog. | |
| Glib::PropertyProxy_ReadOnly < Glib::ustring > | property_heading () const |
| The text to show at the top of the dialog. | |
Protected Member Functions | |
| virtual void | on_custom_item_activated (const Glib::ustring& item_name) |
Related Functions | |
| (Note that these are not member functions.) | |
| Gtk::AppChooserButton* | wrap (GtkAppChooserButton* object, bool take_copy=false) |
| A Glib::wrap() method for this object. | |
A button to launch an application chooser dialog.
This widget lets the user select an application. See the GtkAppChooser base class API.
The AppChooserButton widget looks like this:
| virtual Gtk::AppChooserButton::~AppChooserButton | ( | ) | [virtual] |
| Gtk::AppChooserButton::AppChooserButton | ( | const Glib::ustring & | content_type | ) | [explicit] |
Creates a new app-chooser button for applications that can handle content of the given type.
| content_type | The content type to show applications for |
| void Gtk::AppChooserButton::append_custom_item | ( | const Glib::ustring & | name, |
| const Glib::ustring & | label, | ||
| const Glib::RefPtr< Gio::Icon > & | 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 append_separator().
| name | The name of the custom item. |
| label | The label for the custom item. |
| icon | The icon for the custom item. |
| void Gtk::AppChooserButton::append_separator | ( | ) |
Appends a separator to the list of applications that is shown in the popup.
| Glib::ustring Gtk::AppChooserButton::get_heading | ( | ) | const |
Returns the text to display at the top of the dialog.
0, in which case a default text is displayed. | bool Gtk::AppChooserButton::get_show_dialog_item | ( | ) | const |
Returns the current value of the Gtk::AppChooserButton:show-dialog-item property.
| const GtkAppChooserButton* Gtk::AppChooserButton::gobj | ( | ) | const [inline] |
Provides access to the underlying C GtkObject.
Reimplemented from Gtk::AppChooser.
| GtkAppChooserButton* Gtk::AppChooserButton::gobj | ( | ) | [inline] |
Provides access to the underlying C GtkObject.
Reimplemented from Gtk::AppChooser.
| virtual void Gtk::AppChooserButton::on_custom_item_activated | ( | const Glib::ustring & | item_name | ) | [protected, virtual] |
| Glib::PropertyProxy_ReadOnly<Glib::ustring> Gtk::AppChooserButton::property_heading | ( | ) | const |
The text to show at the top of the dialog.
You rarely need to use properties because there are get_ and set_ methods for almost all of them.
| Glib::PropertyProxy<Glib::ustring> Gtk::AppChooserButton::property_heading | ( | ) |
The text to show at the top of the dialog.
You rarely need to use properties because there are get_ and set_ methods for almost all of them.
| Glib::PropertyProxy_ReadOnly<bool> Gtk::AppChooserButton::property_show_dialog_item | ( | ) | const |
Whether the combobox should include an item that triggers a GtkAppChooserDialog.
You rarely need to use properties because there are get_ and set_ methods for almost all of them.
| Glib::PropertyProxy<bool> Gtk::AppChooserButton::property_show_dialog_item | ( | ) |
Whether the combobox should include an item that triggers a GtkAppChooserDialog.
You rarely need to use properties because there are get_ and set_ methods for almost all of them.
| void Gtk::AppChooserButton::set_active_custom_item | ( | const Glib::ustring & | name | ) |
Selects a custom item previously added with append_custom_item().
Use refresh() to bring the selection to its initial state.
| name | The name of the custom item. |
| void Gtk::AppChooserButton::set_heading | ( | const Glib::ustring & | heading | ) |
Sets the text to display at the top of the dialog.
If the heading is not set, the dialog displays a default text.
| heading | A string containing Pango markup. |
| void Gtk::AppChooserButton::set_show_dialog_item | ( | bool | setting = true | ) |
Sets whether the dropdown menu of this button should show an entry to trigger a Gtk::AppChooserDialog.
| setting | The new value for Gtk::AppChooserButton:show-dialog-item. |
| Glib::SignalProxy1< void,const Glib::ustring& > Gtk::AppChooserButton::signal_custom_item_activated | ( | ) |
void on_my_custom_item_activated(const Glib::ustring& item_name) | Gtk::AppChooserButton* wrap | ( | GtkAppChooserButton * | object, |
| bool | take_copy = false |
||
| ) | [related] |
A Glib::wrap() method for this object.
| object | The C instance. |
| take_copy | False if the result should take ownership of the C instance. True if it should take a new copy or ref. |
1.7.3