gtkmm 3.1.16
Public Member Functions | Protected Member Functions | Related Functions

Gtk::AppChooserWidget Class Reference

An application chooser widget that can be embedded in other widgets. More...

Inheritance diagram for Gtk::AppChooserWidget:
Inheritance graph
[legend]
Collaboration diagram for Gtk::AppChooserWidget:
Collaboration graph
[legend]

List of all members.

Public Member Functions

virtual ~AppChooserWidget ()
GtkAppChooserWidget* gobj ()
 Provides access to the underlying C GtkObject.
const GtkAppChooserWidget* gobj () const
 Provides access to the underlying C GtkObject.
 AppChooserWidget (const Glib::ustring& content_type)
 Creates a new app-chooser widget for applications that can handle content of the given type.
void set_show_default (bool setting=true)
 Sets whether the app chooser should show the default handler for the content type in a separate section.
bool get_show_default ()
 Returns the current value of the Gtk::AppChooserWidget:show-default property.
void set_show_recommended (bool setting=true)
 Sets whether the app chooser should show recommended applications for the content type in a separate section.
bool get_show_recommended () const
 Returns the current value of the Gtk::AppChooserWidget:show-recommended property.
void set_show_fallback (bool setting=true)
 Sets whether the app chooser should show related applications for the content type in a separate section.
bool get_show_fallback () const
 Returns the current value of the Gtk::AppChooserWidget:show-fallback property.
void set_show_other (bool setting=true)
 Sets whether the app chooser should show applications which are unrelated to the content type.
bool get_show_other () const
 Returns the current value of the Gtk::AppChooserWidget:show-other property.
void set_show_all (bool setting=true)
 Sets whether the app chooser should show all applications in a flat list.
bool get_show_all () const
 Returns the current value of the Gtk::AppChooserWidget:show-all property.
void set_default_text (const Glib::ustring& text)
 Sets the text that is shown if there are not applications that can handle the content type.
Glib::ustring get_default_text ()
 Returns the text that is shown if there are not applications that can handle the content type.
Glib::SignalProxy1< void,
const Glib::RefPtr
< Gio::AppInfo >& > 
signal_application_selected ()
Glib::SignalProxy1< void,
const Glib::RefPtr
< Gio::AppInfo >& > 
signal_application_activated ()
Glib::SignalProxy2< void, Menu
*, const Glib::RefPtr
< Gio::AppInfo >& > 
signal_populate_popup ()
Glib::PropertyProxy< bool > property_show_default ()
 Whether the widget should show the default application.
Glib::PropertyProxy_ReadOnly
< bool > 
property_show_default () const
 Whether the widget should show the default application.
Glib::PropertyProxy< bool > property_show_recommended ()
 Whether the widget should show recommended applications.
Glib::PropertyProxy_ReadOnly
< bool > 
property_show_recommended () const
 Whether the widget should show recommended applications.
Glib::PropertyProxy< bool > property_show_fallback ()
 Whether the widget should show fallback applications.
Glib::PropertyProxy_ReadOnly
< bool > 
property_show_fallback () const
 Whether the widget should show fallback applications.
Glib::PropertyProxy< bool > property_show_other ()
 Whether the widget should show other applications.
Glib::PropertyProxy_ReadOnly
< bool > 
property_show_other () const
 Whether the widget should show other applications.
Glib::PropertyProxy< bool > property_show_all ()
 Whether the widget should show all applications.
Glib::PropertyProxy_ReadOnly
< bool > 
property_show_all () const
 Whether the widget should show all applications.
Glib::PropertyProxy
< Glib::ustring
property_default_text ()
 The default text appearing when there are no applications.
Glib::PropertyProxy_ReadOnly
< Glib::ustring
property_default_text () const
 The default text appearing when there are no applications.

Protected Member Functions

virtual void on_application_selected (const Glib::RefPtr< Gio::AppInfo >& app_info)
virtual void on_application_activated (const Glib::RefPtr< Gio::AppInfo >& app_info)
virtual void on_populate_popup (Menu* menu, const Glib::RefPtr< Gio::AppInfo >& app_info)

Related Functions

(Note that these are not member functions.)
Gtk::AppChooserWidgetwrap (GtkAppChooserWidget* object, bool take_copy=false)
 A Glib::wrap() method for this object.

Detailed Description

An application chooser widget that can be embedded in other widgets.

This widget is for selecting applications. It is the main building block for AppChooserDialog. Most applications only need to use the latter, but you can use this widget as part of a larger widget if you have special needs.

The AppChooserWidget widget looks like this:

appchooserwidget1.png
Since gtkmm 3.0:

Constructor & Destructor Documentation

virtual Gtk::AppChooserWidget::~AppChooserWidget ( ) [virtual]
Gtk::AppChooserWidget::AppChooserWidget ( const Glib::ustring content_type) [explicit]

Creates a new app-chooser widget for applications that can handle content of the given type.

Parameters:
content_typeThe content type to show applications for

Member Function Documentation

Glib::ustring Gtk::AppChooserWidget::get_default_text ( )

Returns the text that is shown if there are not applications that can handle the content type.

Since gtkmm 3.0:
Returns:
The value of Gtk::AppChooserWidget:default-text.
bool Gtk::AppChooserWidget::get_show_all ( ) const

Returns the current value of the Gtk::AppChooserWidget:show-all property.

Since gtkmm 3.0:
Returns:
The value of Gtk::AppChooserWidget:show-all.
bool Gtk::AppChooserWidget::get_show_default ( )

Returns the current value of the Gtk::AppChooserWidget:show-default property.

Since gtkmm 3.0:
Returns:
The value of Gtk::AppChooserWidget:show-default.
bool Gtk::AppChooserWidget::get_show_fallback ( ) const

Returns the current value of the Gtk::AppChooserWidget:show-fallback property.

Since gtkmm 3.0:
Returns:
The value of Gtk::AppChooserWidget:show-fallback.
bool Gtk::AppChooserWidget::get_show_other ( ) const

Returns the current value of the Gtk::AppChooserWidget:show-other property.

Since gtkmm 3.0:
Returns:
The value of Gtk::AppChooserWidget:show-other.
bool Gtk::AppChooserWidget::get_show_recommended ( ) const

Returns the current value of the Gtk::AppChooserWidget:show-recommended property.

Since gtkmm 3.0:
Returns:
The value of Gtk::AppChooserWidget:show-recommended.
const GtkAppChooserWidget* Gtk::AppChooserWidget::gobj ( ) const [inline]

Provides access to the underlying C GtkObject.

Reimplemented from Gtk::AppChooser.

GtkAppChooserWidget* Gtk::AppChooserWidget::gobj ( ) [inline]

Provides access to the underlying C GtkObject.

Reimplemented from Gtk::AppChooser.

virtual void Gtk::AppChooserWidget::on_application_activated ( const Glib::RefPtr< Gio::AppInfo > &  app_info) [protected, virtual]
virtual void Gtk::AppChooserWidget::on_application_selected ( const Glib::RefPtr< Gio::AppInfo > &  app_info) [protected, virtual]
virtual void Gtk::AppChooserWidget::on_populate_popup ( Menu menu,
const Glib::RefPtr< Gio::AppInfo > &  app_info 
) [protected, virtual]
Glib::PropertyProxy_ReadOnly<Glib::ustring> Gtk::AppChooserWidget::property_default_text ( ) const

The default text appearing when there are no applications.

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::AppChooserWidget::property_default_text ( )

The default text appearing when there are no applications.

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::AppChooserWidget::property_show_all ( ) const

Whether the widget should show all applications.

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::AppChooserWidget::property_show_all ( )

Whether the widget should show all applications.

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::AppChooserWidget::property_show_default ( )

Whether the widget should show the default application.

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::AppChooserWidget::property_show_default ( ) const

Whether the widget should show the default application.

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::AppChooserWidget::property_show_fallback ( )

Whether the widget should show fallback applications.

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::AppChooserWidget::property_show_fallback ( ) const

Whether the widget should show fallback applications.

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::AppChooserWidget::property_show_other ( )

Whether the widget should show other applications.

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::AppChooserWidget::property_show_other ( ) const

Whether the widget should show other applications.

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::AppChooserWidget::property_show_recommended ( )

Whether the widget should show recommended applications.

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::AppChooserWidget::property_show_recommended ( ) const

Whether the widget should show recommended applications.

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::AppChooserWidget::set_default_text ( const Glib::ustring text)

Sets the text that is shown if there are not applications that can handle the content type.

Parameters:
textThe new value for Gtk::AppChooserWidget:default-text.
void Gtk::AppChooserWidget::set_show_all ( bool  setting = true)

Sets whether the app chooser should show all applications in a flat list.

Since gtkmm 3.0:
Parameters:
settingThe new value for Gtk::AppChooserWidget:show-all.
void Gtk::AppChooserWidget::set_show_default ( bool  setting = true)

Sets whether the app chooser should show the default handler for the content type in a separate section.

Since gtkmm 3.0:
Parameters:
settingThe new value for Gtk::AppChooserWidget:show-default.
void Gtk::AppChooserWidget::set_show_fallback ( bool  setting = true)

Sets whether the app chooser should show related applications for the content type in a separate section.

Since gtkmm 3.0:
Parameters:
settingThe new value for Gtk::AppChooserWidget:show-fallback.
void Gtk::AppChooserWidget::set_show_other ( bool  setting = true)

Sets whether the app chooser should show applications which are unrelated to the content type.

Since gtkmm 3.0:
Parameters:
settingThe new value for Gtk::AppChooserWidget:show-other.
void Gtk::AppChooserWidget::set_show_recommended ( bool  setting = true)

Sets whether the app chooser should show recommended applications for the content type in a separate section.

Since gtkmm 3.0:
Parameters:
settingThe new value for Gtk::AppChooserWidget:show-recommended.
Glib::SignalProxy1< void,const Glib::RefPtr<Gio::AppInfo>& > Gtk::AppChooserWidget::signal_application_activated ( )
Prototype:
void on_my_application_activated(const Glib::RefPtr<Gio::AppInfo>& app_info)
Glib::SignalProxy1< void,const Glib::RefPtr<Gio::AppInfo>& > Gtk::AppChooserWidget::signal_application_selected ( )
Prototype:
void on_my_application_selected(const Glib::RefPtr<Gio::AppInfo>& app_info)
Glib::SignalProxy2< void,Menu*,const Glib::RefPtr<Gio::AppInfo>& > Gtk::AppChooserWidget::signal_populate_popup ( )
Prototype:
void on_my_populate_popup(Menu* menu, const Glib::RefPtr<Gio::AppInfo>& app_info)

Friends And Related Function Documentation

Gtk::AppChooserWidget* wrap ( GtkAppChooserWidget *  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: