gtkmm 3.1.16
|
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. |