Gtk::MenuToolButton Class Reference
[Widgets]

A Gtk::ToolItem containing a toggle button. More...

Inherits Gtk::ToolButton.

Collaboration diagram for Gtk::MenuToolButton:

[legend]

List of all members.

Public Member Functions
virtual	~MenuToolButton ()
GtkMenuToolButton*	gobj ()
	Provides access to the underlying C GtkObject.
const GtkMenuToolButton*	gobj () const
	Provides access to the underlying C GtkObject.
	MenuToolButton ()
	Creates a new MenuToolButton.
	MenuToolButton (const Gtk::StockID& stock_id)
	Creates a new MenuToolButton from a StockID.
	MenuToolButton (const Glib::ustring& label)
	Creates a new MenuToolButton with a label.
	MenuToolButton (Widget& icon_widget, const Glib::ustring& label=Glib::ustring())
	Creates a new MenuToolButton with an image.
void	set_menu (Menu& menu)
	Sets the Gtk::Menu that is popped up when the user clicks on the arrow.
Menu*	get_menu ()
	Gets the Gtk::Menu associated with Gtk::MenuToolButton.
const Menu*	get_menu () const
	Gets the Gtk::Menu associated with Gtk::MenuToolButton.
void	set_arrow_tooltip (Tooltips& tooltips, const Glib::ustring& tip_text, const Glib::ustring& tip_private)
	Sets the Gtk::Tooltips object to be used for arrow button which pops up the menu.
void	set_arrow_tooltip_text (const Glib::ustring& text)
	Sets the tooltip text to be used as tooltip for the arrow button which pops up the menu.
void	set_arrow_tooltip_markup (const Glib::ustring& markup)
	Sets the tooltip markup text to be used as tooltip for the arrow button which pops up the menu.
Glib::SignalProxy0< void >	signal_show_menu ()
Glib::PropertyProxy< Menu* >	property_menu ()
	The dropdown menu.
Glib::PropertyProxy_ReadOnly < Menu* >	property_menu () const
	The dropdown menu.
Protected Member Functions
virtual void	on_show_menu ()
Related Functions
(Note that these are not member functions.)
Gtk::MenuToolButton*	wrap (GtkMenuToolButton* object, bool take_copy=false)
	A Glib::wrap() method for this object.

---

Detailed Description

A Gtk::ToolItem containing a toggle button.

A MenuToolButton is a Gtk::ToolItem that contains a menu.

---

Constructor & Destructor Documentation

virtual Gtk::MenuToolButton::~MenuToolButton

(

)

[virtual]

Gtk::MenuToolButton::MenuToolButton

(

)

Creates a new MenuToolButton.

Gtk::MenuToolButton::MenuToolButton

(

const Gtk::StockID&

stock_id

)

[explicit]

Creates a new MenuToolButton from a StockID.

The MenuToolButton will be created according to the stock_id properties.

Parameters:

stock_id

The StockID which determines the look of the MenuToolButton.

Gtk::MenuToolButton::MenuToolButton

(

const Glib::ustring &

label

)

[explicit]

Creates a new MenuToolButton with a label.

The MenuToolButton will have the label label.

Parameters:

label

The string used to display the label for this MenuToolButton.

Gtk::MenuToolButton::MenuToolButton	(	Widget&	icon_widget,
		const Glib::ustring &	label = Glib::ustring()
	)			[explicit]

Creates a new MenuToolButton with an image.

The MenuToolButton will have the label label and an image widget icon_widget.

Parameters:

	icon_widget	The widget placed as the MenuToolButton's icon.
	label	The string used to display the label for this MenuToolButton.

---

Member Function Documentation

const Menu* Gtk::MenuToolButton::get_menu

(

)

const

Gets the Gtk::Menu associated with Gtk::MenuToolButton.

Since gtkmm 2.6:

Returns:

The Gtk::Menu associated with Gtk::MenuToolButton.

Menu* Gtk::MenuToolButton::get_menu

(

)

Gets the Gtk::Menu associated with Gtk::MenuToolButton.

Since gtkmm 2.6:

Returns:

The Gtk::Menu associated with Gtk::MenuToolButton.

const GtkMenuToolButton* Gtk::MenuToolButton::gobj

(

)

const [inline]

Provides access to the underlying C GtkObject.

Reimplemented from Gtk::ToolButton.

GtkMenuToolButton* Gtk::MenuToolButton::gobj

(

)

[inline]

Provides access to the underlying C GtkObject.

Reimplemented from Gtk::ToolButton.

virtual void Gtk::MenuToolButton::on_show_menu

(

)

[protected, virtual]

Glib::PropertyProxy_ReadOnly<Menu*> Gtk::MenuToolButton::property_menu

(

)

const

The dropdown menu.

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<Menu*> Gtk::MenuToolButton::property_menu

(

)

The dropdown menu.

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::MenuToolButton::set_arrow_tooltip	(	Tooltips&	tooltips,
		const Glib::ustring &	tip_text,
		const Glib::ustring &	tip_private
	)

Sets the Gtk::Tooltips object to be used for arrow button which pops up the menu.

See Gtk::ToolItem::set_tooltip() for setting a tooltip on the whole Gtk::MenuToolButton.

Since gtkmm 2.6:

Deprecated: 2.12: Use set_arrow_tooltip_text() instead.

Deprecated:

Use set_arrow_tooltip_text() or set_arrow_tooltip_markup() instead

Parameters:

	tooltips	The Gtk::Tooltips object to be used.
	tip_text	Text to be used as tooltip text for tool_item.
	tip_private	Text to be used as private tooltip text.

void Gtk::MenuToolButton::set_arrow_tooltip_markup

(

const Glib::ustring &

markup

)

Sets the tooltip markup text to be used as tooltip for the arrow button which pops up the menu.

See Gtk::ToolItem::set_tooltip() for setting a tooltip on the whole Gtk::MenuToolButton.

Since gtkmm 2.12:

Parameters:

markup

Markup text to be used as tooltip text for button's arrow button.

void Gtk::MenuToolButton::set_arrow_tooltip_text

(

const Glib::ustring &

text

)

Sets the tooltip text to be used as tooltip for the arrow button which pops up the menu.

See Gtk::ToolItem::set_tooltip() for setting a tooltip on the whole Gtk::MenuToolButton.

Since gtkmm 2.12:

Parameters:

text

Text to be used as tooltip text for button's arrow button.

void Gtk::MenuToolButton::set_menu

(

Menu&

menu

)

Sets the Gtk::Menu that is popped up when the user clicks on the arrow.

If menu is 0, the arrow button becomes insensitive.

Since gtkmm 2.6:

Parameters:

menu

The Gtk::Menu associated with Gtk::MenuToolButton.

Glib::SignalProxy0< void > Gtk::MenuToolButton::signal_show_menu

(

)

Prototype:

void on_my_show_menu()

---

Friends And Related Function Documentation

Gtk::MenuToolButton* wrap	(	GtkMenuToolButton *	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:

• gtkmm/menutoolbutton.h