gtkmm: Gtk::AppChooserButton Class Reference

A button to launch an application chooser dialog. More...

Inheritance diagram for Gtk::AppChooserButton:
Collaboration diagram for Gtk::AppChooserButton:

List of all members.

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 ()
void append_custom_item (const Glib::ustring& name, const Glib::ustring& label, const Glib::RefPtr< Gio::Icon >& icon)
void set_active_custom_item (const Glib::ustring& name)
void set_show_dialog_item (bool setting=true)
bool get_show_dialog_item () const
void set_heading (const Glib::ustring& heading)
Glib::ustring get_heading () const
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::AppChooserButtonwrap (GtkAppChooserButton* object, bool take_copy=false)
 A Glib::wrap() method for this object.


Detailed Description

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:

appchooserbutton1.png
Since gtkmm 3.0:

Constructor & Destructor Documentation

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.

Parameters:
content_typeThe content type to show applications for

Member Function Documentation

void Gtk::AppChooserButton::append_custom_item ( const Glib::ustring name,
const Glib::ustring label,
const Glib::RefPtr< Gio::Icon > &  icon 
)
void Gtk::AppChooserButton::append_separator ( )
Glib::ustring Gtk::AppChooserButton::get_heading ( ) const
bool Gtk::AppChooserButton::get_show_dialog_item ( ) const
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.

Returns:
A PropertyProxy that allows you to get or set the property of the value, or receive notification when the value of the property changes.
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.

Returns:
A PropertyProxy that allows you to get or set the property of the value, or receive notification when the value of the property changes.
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.

Returns:
A PropertyProxy that allows you to get or set the property of the value, or receive notification when the value of the property changes.
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.

Returns:
A PropertyProxy that allows you to get or set the property of the value, or receive notification when the value of the property changes.
void Gtk::AppChooserButton::set_active_custom_item ( const Glib::ustring name)
void Gtk::AppChooserButton::set_heading ( const Glib::ustring heading)
void Gtk::AppChooserButton::set_show_dialog_item ( bool  setting = true)
Glib::SignalProxy1< void,const Glib::ustring& > Gtk::AppChooserButton::signal_custom_item_activated ( )
Prototype:
void on_my_custom_item_activated(const Glib::ustring& item_name)

Friends And Related Function Documentation

Gtk::AppChooserButton* wrap ( GtkAppChooserButton *  object,
bool  take_copy = false 
) [related]

A Glib::wrap() method for this object.

Parameters:
objectThe C instance.
take_copyFalse if the result should take ownership of the C instance. True if it should take a new copy or ref.
Returns:
A C++ instance that wraps this C instance.

The documentation for this class was generated from the following file:
  • gtkmm/appchooserbutton.h