Gtk::ToggleAction Class Reference

Detailed Description
An action which can be toggled between two states.A Gtk::ToggleAction corresponds roughly to a Gtk::CheckMenuItem. It has an "active" state specifying whether the action has been checked or not.
Public Member Functions | |
bool | get_active () const |
Returns: the checked state of the toggle action. | |
bool | get_draw_as_radio () const |
Returns: whether the action should have proxies like a radio action. | |
const GtkToggleAction* | gobj () const |
Provides access to the underlying C GObject. | |
GtkToggleAction* | gobj () |
Provides access to the underlying C GObject. | |
GtkToggleAction* | gobj_copy () |
Provides access to the underlying C instance. The caller is responsible for unrefing it. Use when directly setting fields in structs. | |
Glib::PropertyProxy_ReadOnly <bool> | property_draw_as_radio () const |
Whether the proxies for this action look like radio action proxies. | |
Glib::PropertyProxy<bool> | property_draw_as_radio () |
Whether the proxies for this action look like radio action proxies. | |
void | set_active (bool is_active=true) |
Sets the checked state on the toggle action. | |
void | set_draw_as_radio (bool draw_as_radio=true) |
Sets whether the action should have proxies like a radio action. | |
Glib::SignalProxy0<void> | signal_toggled () |
void | toggled () |
Emits the "toggled" signal on the toggle action. | |
virtual | ~ToggleAction () |
Static Public Member Functions | |
static Glib::RefPtr<ToggleAction> | create (const Glib::ustring& name, const Gtk::StockID& stock_id, const Glib::ustring& label=Glib::ustring(), const Glib::ustring& tooltip=Glib::ustring(), bool is_active=false) |
Creates a toggle action with a stock ID. | |
static Glib::RefPtr<ToggleAction> | create (const Glib::ustring& name, const Glib::ustring& label=Glib::ustring(), const Glib::ustring& tooltip=Glib::ustring(), bool is_active=false) |
Creates a toggle action. | |
static Glib::RefPtr<ToggleAction> | create () |
static Glib::RefPtr<ToggleAction> | create_with_icon_name (const Glib::ustring& name, const Glib::ustring& icon_name, const Glib::ustring& label, const Glib::ustring& tooltip, bool is_active=false) |
Creates a toggle action with an icon name. | |
Protected Member Functions | |
virtual void | on_toggled () |
ToggleAction (const Glib::ustring& name, const Glib::ustring& icon_name, const Glib::ustring& label=Glib::ustring(), const Glib::ustring& tooltip=Glib::ustring(), bool is_active=false) | |
Creates a toggle action with an icon name. | |
ToggleAction (const Glib::ustring& name, const StockID& stock_id=StockID(), const Glib::ustring& label=Glib::ustring(), const Glib::ustring& tooltip=Glib::ustring(), bool is_active=false) | |
Creates a toggle action. | |
ToggleAction () | |
Creates an empty toggle action. | |
Related Functions | |
(Note that these are not member functions.) | |
Glib::RefPtr<Gtk::ToggleAction> | wrap (GtkToggleAction* object, bool take_copy=false) |
A Glib::wrap() method for this object. |
Constructor & Destructor Documentation
virtual Gtk::ToggleAction::~ToggleAction | ( | ) | [virtual] |
Gtk::ToggleAction::ToggleAction | ( | ) | [protected] |
Creates an empty toggle action.
Gtk::ToggleAction::ToggleAction | ( | const Glib::ustring & | name, | |
const StockID& | stock_id = StockID() , |
|||
const Glib::ustring & | label = Glib::ustring() , |
|||
const Glib::ustring & | tooltip = Glib::ustring() , |
|||
bool | is_active = false | |||
) | [explicit, protected] |
Creates a toggle action.
- Parameters:
-
name A unique name for the action. stock_id The stock icon to display in widgets representing the action. label The label displayed in menu items and on buttons. tooltip A tooltip for the action. is_active The default checked state of the action.
Gtk::ToggleAction::ToggleAction | ( | const Glib::ustring & | name, | |
const Glib::ustring & | icon_name, | |||
const Glib::ustring & | label = Glib::ustring() , |
|||
const Glib::ustring & | tooltip = Glib::ustring() , |
|||
bool | is_active = false | |||
) | [explicit, protected] |
Creates a toggle action with an icon name.
The toggle action's icon will reflect the specified icon name in the user's icon theme.
- Parameters:
-
name A unique name for the action. icon_name An IconTheme icon name used for widgets representing the action. label The label displayed in menu items and on buttons. tooltip A tooltip for the action. is_active The default checked state of the action.
Member Function Documentation
static Glib::RefPtr<ToggleAction> Gtk::ToggleAction::create | ( | const Glib::ustring & | name, | |
const Gtk::StockID& | stock_id, | |||
const Glib::ustring & | label = Glib::ustring() , |
|||
const Glib::ustring & | tooltip = Glib::ustring() , |
|||
bool | is_active = false | |||
) | [static] |
Creates a toggle action with a stock ID.
The tock ID is used to set a default icon, text and accelerator for the toggle action.
- Parameters:
-
name A unique name for the action. stock_id The stock icon to display in widgets representing the action. label The label displayed in menu items and on buttons. tooltip A tooltip for the action. is_active The default checked state of the action.
- Returns:
- A new ToggleAction.
static Glib::RefPtr<ToggleAction> Gtk::ToggleAction::create | ( | const Glib::ustring & | name, | |
const Glib::ustring & | label = Glib::ustring() , |
|||
const Glib::ustring & | tooltip = Glib::ustring() , |
|||
bool | is_active = false | |||
) | [static] |
Creates a toggle action.
- Parameters:
-
name A unique name for the action. label The label displayed in menu items and on buttons. tooltip A tooltip for the action. is_active The default checked state of the action.
- Returns:
- A new ToggleAction.
static Glib::RefPtr<ToggleAction> Gtk::ToggleAction::create | ( | ) | [static] |
static Glib::RefPtr<ToggleAction> Gtk::ToggleAction::create_with_icon_name | ( | const Glib::ustring & | name, | |
const Glib::ustring & | icon_name, | |||
const Glib::ustring & | label, | |||
const Glib::ustring & | tooltip, | |||
bool | is_active = false | |||
) | [static] |
Creates a toggle action with an icon name.
The toggle action's icon will reflect the specified icon name in the user's icon theme.
- Parameters:
-
name A unique name for the action. icon_name An IconTheme icon name used for widgets representing the action. label The label displayed in menu items and on buttons. tooltip A tooltip for the action. is_active The default checked state of the action.
- Returns:
- A new ToggleAction.
bool Gtk::ToggleAction::get_active | ( | ) | const |
Returns: the checked state of the toggle action.
- Returns:
- The checked state of the toggle action
bool Gtk::ToggleAction::get_draw_as_radio | ( | ) | const |
Returns: whether the action should have proxies like a radio action.
- Returns:
- Whether the action should have proxies like a radio action.
const GtkToggleAction* Gtk::ToggleAction::gobj | ( | ) | const [inline] |
Provides access to the underlying C GObject.
Reimplemented from Gtk::Action.
Reimplemented in Gtk::RadioAction.
GtkToggleAction* Gtk::ToggleAction::gobj | ( | ) | [inline] |
Provides access to the underlying C GObject.
Reimplemented from Gtk::Action.
Reimplemented in Gtk::RadioAction.
GtkToggleAction* Gtk::ToggleAction::gobj_copy | ( | ) |
Provides access to the underlying C instance. The caller is responsible for unrefing it. Use when directly setting fields in structs.
Reimplemented from Gtk::Action.
Reimplemented in Gtk::RadioAction.
virtual void Gtk::ToggleAction::on_toggled | ( | ) | [protected, virtual] |
Glib::PropertyProxy_ReadOnly<bool> Gtk::ToggleAction::property_draw_as_radio | ( | ) | const |
Whether the proxies for this action look like radio action proxies.
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::ToggleAction::property_draw_as_radio | ( | ) |
Whether the proxies for this action look like radio action proxies.
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::ToggleAction::set_active | ( | bool | is_active = true |
) |
Sets the checked state on the toggle action.
- Parameters:
-
is_active Whether the action should be checked or not.
void Gtk::ToggleAction::set_draw_as_radio | ( | bool | draw_as_radio = true |
) |
Sets whether the action should have proxies like a radio action.
- Parameters:
-
draw_as_radio Whether the action should have proxies like a radio action.
Glib::SignalProxy0< void > Gtk::ToggleAction::signal_toggled | ( | ) |
- Prototype:
void on_my_toggled()
void Gtk::ToggleAction::toggled | ( | ) |
Friends And Related Function Documentation
Glib::RefPtr<Gtk::ToggleAction> wrap | ( | GtkToggleAction * | object, | |
bool | take_copy = false | |||
) | [related] |
A Glib::wrap() method for this object.
- Parameters:
-
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.
- Returns:
- A C++ instance that wraps this C instance.
The documentation for this class was generated from the following file: