<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<title>gtkmm: Gtk::Button Class Reference</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<link href="doxygen.css" rel="stylesheet" type="text/css"/>
</head>
<body>
<!-- Generated by Doxygen 1.7.3 -->
<div id="top">
<div id="titlearea">
<table cellspacing="0" cellpadding="0">
<tbody>
<tr style="height: 56px;">
<td style="padding-left: 0.5em;">
<div id="projectname">gtkmm <span id="projectnumber">2.24.4</span></div>
</td>
</tr>
</tbody>
</table>
</div>
<div id="navrow1" class="tabs">
<ul class="tablist">
<li><a href="index.html"><span>Main Page</span></a></li>
<li><a href="pages.html"><span>Related Pages</span></a></li>
<li><a href="modules.html"><span>Modules</span></a></li>
<li><a href="namespaces.html"><span>Namespaces</span></a></li>
<li class="current"><a href="annotated.html"><span>Classes</span></a></li>
</ul>
</div>
<div id="navrow2" class="tabs2">
<ul class="tablist">
<li><a href="annotated.html"><span>Class List</span></a></li>
<li><a href="classes.html"><span>Class Index</span></a></li>
<li><a href="inherits.html"><span>Class Hierarchy</span></a></li>
<li><a href="functions.html"><span>Class Members</span></a></li>
</ul>
</div>
<div id="nav-path" class="navpath">
<ul>
<li class="navelem"><a class="el" href="namespaceGtk.html">Gtk</a> </li>
<li class="navelem"><a class="el" href="classGtk_1_1Button.html">Button</a> </li>
</ul>
</div>
</div>
<div class="header">
<div class="summary">
<a href="#pub-methods">Public Member Functions</a> |
<a href="#pro-methods">Protected Member Functions</a> |
<a href="#related">Related Functions</a> </div>
<div class="headertitle">
<h1>Gtk::Button Class Reference<div class="ingroups"><a class="el" href="group__Widgets.html">Widgets</a></div></h1> </div>
</div>
<div class="contents">
<!-- doxytag: class="Gtk::Button" --><!-- doxytag: inherits="Gtk::Bin" -->
<p>A widget that creates a signal when clicked on. <a href="#_details">More...</a></p>
<div class="dynheader">
Inheritance diagram for Gtk::Button:</div>
<div class="dyncontent">
<div class="center"><img src="classGtk_1_1Button__inherit__graph.png" border="0" usemap="#Gtk_1_1Button_inherit__map" alt="Inheritance graph"/></div>
<map name="Gtk_1_1Button_inherit__map" id="Gtk_1_1Button_inherit__map">
<area shape="rect" id="node19" href="classGtk_1_1ColorButton.html" title="A button to launch a color selection dialog." alt="" coords="1244,5,1372,35"/><area shape="rect" id="node21" href="classGtk_1_1FontButton.html" title="A button to launch a font selection dialog." alt="" coords="1247,59,1369,88"/><area shape="rect" id="node23" href="classGtk_1_1LinkButton.html" title="Create buttons bound to a URL." alt="" coords="1248,112,1368,141"/><area shape="rect" id="node25" href="classGtk_1_1OptionMenu.html" title="A widget used to choose from a list of valid choices." alt="" coords="1244,165,1372,195"/><area shape="rect" id="node27" href="classGtk_1_1ScaleButton.html" title="A button which pops up a scale widget." alt="" coords="1243,219,1373,248"/><area shape="rect" id="node31" href="classGtk_1_1ToggleButton.html" title="A Gtk::ToggleButton will remain 'pressed-in' when clicked." alt="" coords="1241,272,1375,301"/><area shape="rect" id="node2" href="classGtk_1_1Bin.html" title="A container with just one child." alt="" coords="976,139,1048,168"/><area shape="rect" id="node4" href="classGtk_1_1Container.html" title="Abstract container class." alt="" coords="813,139,928,168"/><area shape="rect" id="node6" href="classGtk_1_1Widget.html" title="Abstract Widget (Base class for all widgets)" alt="" coords="671,139,764,168"/><area shape="rect" id="node8" href="classGtk_1_1Object.html" title="Gtk::Object is the base class for all widgets, and for a few non-widget objects such as Gtk::Adjustme..." alt="" coords="508,112,601,141"/><area shape="rect" id="node10" href="../../../glibmm-2.4/reference/html/classGlib_1_1Object.html" title="Glib::Object" alt="" coords="345,112,439,141"/><area shape="rect" id="node12" href="../../../glibmm-2.4/reference/html/classGlib_1_1ObjectBase.html" title="Glib::ObjectBase" alt="" coords="169,112,295,141"/><area shape="rect" id="node14" href="../../../libsigc++-2.0/reference/html/structsigc_1_1trackable.html" title="sigc::trackable" alt="" coords="5,112,120,141"/><area shape="rect" id="node16" href="classAtk_1_1Implementor.html" title="Atk::Implementor" alt="" coords="488,165,621,195"/><area shape="rect" id="node29" href="classGtk_1_1VolumeButton.html" title="A button which pops up a volume control." alt="" coords="1425,219,1567,248"/><area shape="rect" id="node33" href="classGtk_1_1CheckButton.html" title="Create widgets with a discrete toggle button." alt="" coords="1429,272,1563,301"/><area shape="rect" id="node35" href="classGtk_1_1RadioButton.html" title="A single radio button performs the same basic function as a Gtk::CheckButton, as its position in the ..." alt="" coords="1616,272,1747,301"/></map>
<center><span class="legend">[<a href="graph_legend.html">legend</a>]</span></center></div>
<div class="dynheader">
Collaboration diagram for Gtk::Button:</div>
<div class="dyncontent">
<div class="center"><img src="classGtk_1_1Button__coll__graph.png" border="0" usemap="#Gtk_1_1Button_coll__map" alt="Collaboration graph"/></div>
<map name="Gtk_1_1Button_coll__map" id="Gtk_1_1Button_coll__map">
<area shape="rect" id="node2" href="classGtk_1_1Bin.html" title="A container with just one child." alt="" coords="100,469,172,499"/><area shape="rect" id="node4" href="classGtk_1_1Container.html" title="Abstract container class." alt="" coords="79,392,193,421"/><area shape="rect" id="node6" href="classGtk_1_1Widget.html" title="Abstract Widget (Base class for all widgets)" alt="" coords="89,315,183,344"/><area shape="rect" id="node8" href="classGtk_1_1Object.html" title="Gtk::Object is the base class for all widgets, and for a few non-widget objects such as Gtk::Adjustme..." alt="" coords="21,237,115,267"/><area shape="rect" id="node10" href="../../../glibmm-2.4/reference/html/classGlib_1_1Object.html" title="Glib::Object" alt="" coords="21,160,115,189"/><area shape="rect" id="node12" href="../../../glibmm-2.4/reference/html/classGlib_1_1ObjectBase.html" title="Glib::ObjectBase" alt="" coords="5,83,131,112"/><area shape="rect" id="node14" href="../../../libsigc++-2.0/reference/html/structsigc_1_1trackable.html" title="sigc::trackable" alt="" coords="11,5,125,35"/><area shape="rect" id="node16" href="classAtk_1_1Implementor.html" title="Atk::Implementor" alt="" coords="139,237,272,267"/></map>
<center><span class="legend">[<a href="graph_legend.html">legend</a>]</span></center></div>
<p><a href="classGtk_1_1Button-members.html">List of all members.</a></p>
<table class="memberdecls">
<tr><td colspan="2"><h2><a name="pub-methods"></a>
Public Member Functions</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">virtual </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Button.html#a188bfc5caf8e3c68d6d80b54186d8961">~Button</a> ()</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">GtkButton* </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Button.html#aac9db3896fa8b7576c6f3720846faa1c">gobj</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Provides access to the underlying C GtkObject. <a href="#aac9db3896fa8b7576c6f3720846faa1c"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">const GtkButton* </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Button.html#a9ea06156c54545902608286d1a0d0e42">gobj</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Provides access to the underlying C GtkObject. <a href="#a9ea06156c54545902608286d1a0d0e42"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Button.html#a122a26893f0efe761712c453b83e6714">Button</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Create an empty button. <a href="#a122a26893f0efe761712c453b83e6714"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Button.html#a405a4a0363e4be77a71ed83c8fb61b44">Button</a> (const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a>& label, bool mnemonic=false)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Simple Push <a class="el" href="classGtk_1_1Button.html" title="A widget that creates a signal when clicked on.">Button</a> with label. <a href="#a405a4a0363e4be77a71ed83c8fb61b44"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Button.html#af44d6e2efbb8342da17f7259626e67cc">Button</a> (const <a class="el" href="classGtk_1_1StockID.html">StockID</a>& stock_id)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Creates a new <a class="el" href="classGtk_1_1Button.html" title="A widget that creates a signal when clicked on.">Button</a> containing the image and text from a stock item. <a href="#af44d6e2efbb8342da17f7259626e67cc"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Button.html#a44480a361b5089689676f62d798d8351">pressed</a> ()</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Button.html#afc33139cc82d05b108d791d63fceeecb">released</a> ()</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Button.html#af4b7ec50762018dac1ce42b8d1a4a797">clicked</a> ()</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Button.html#a24a8b5ff7cb9286319643ab5c672ce10">enter</a> ()</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Button.html#a4ef2c72ff49b7a51cd51bc34fcf2a9ad">leave</a> ()</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Button.html#aaeee84797391945df559ebe1c0b88c1e">set_relief</a> (<a class="el" href="group__gtkmmEnums.html#ga11df7b40133f3cd29b07bd87c969ff42">ReliefStyle</a> newstyle)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__gtkmmEnums.html#ga11df7b40133f3cd29b07bd87c969ff42">ReliefStyle</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Button.html#a2c902cb0c0ac00b26d23a2b04571f9b1">get_relief</a> () const </td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Button.html#ad3f9e419fc13a942f679a8545f0d96b6">set_label</a> (const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a>& label)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Sets the text of the label of the button to <em>str</em>. <a href="#ad3f9e419fc13a942f679a8545f0d96b6"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Button.html#ae377dbb125d9beb6e6fdd5b191f785aa">get_label</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Fetches the text from the label of the button, as set by <a class="el" href="classGtk_1_1Button.html#ad3f9e419fc13a942f679a8545f0d96b6" title="Sets the text of the label of the button to str.">set_label()</a>. <a href="#ae377dbb125d9beb6e6fdd5b191f785aa"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Button.html#a9c5e6c68d197342c751a22e0403c8e95">set_use_underline</a> (bool use_underline=true)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">If true, an underline in the text of the button label indicates the next character should be used for the mnemonic accelerator key. <a href="#a9c5e6c68d197342c751a22e0403c8e95"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Button.html#a6570250c1d48265aae83b8b6b1eb662f">get_use_underline</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns whether an embedded underline in the button label indicates a mnemonic. <a href="#a6570250c1d48265aae83b8b6b1eb662f"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Button.html#ad50fe8ec5243d13e8d146c54d12cf5a8">set_use_stock</a> (bool use_stock=true)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">If <code>true</code>, the label set on the button is used as a stock id to select the stock item for the button. <a href="#ad50fe8ec5243d13e8d146c54d12cf5a8"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Button.html#aa79490e3b6c63a89d0552790792e1b9b">get_use_stock</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns whether the button label is a stock item. <a href="#aa79490e3b6c63a89d0552790792e1b9b"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Button.html#aab691cee055c3e2850dcb968f7bf94c9">set_focus_on_click</a> (bool focus_on_click=true)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Sets whether the button will grab focus when it is clicked with the mouse. <a href="#aab691cee055c3e2850dcb968f7bf94c9"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Button.html#ab1800f6488996503da0e80613d52e6fb">get_focus_on_click</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns whether the button grabs focus when it is clicked with the mouse. <a href="#ab1800f6488996503da0e80613d52e6fb"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Button.html#a7b204372b3ee1395290cfad7033c08fb">set_alignment</a> (float xalign, float yalign)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Sets the alignment of the child. <a href="#a7b204372b3ee1395290cfad7033c08fb"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Button.html#a5077c50492734651ff9669f7ef1c8d47">get_alignment</a> (float& xalign, float& yalign)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Gets the alignment of the child in the button. <a href="#a5077c50492734651ff9669f7ef1c8d47"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Button.html#ac49972018a8ed3392e897cdf9da66391">set_image</a> (<a class="el" href="classGtk_1_1Widget.html">Widget</a>& image)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Set the image of <em>button</em> to the given widget. <a href="#ac49972018a8ed3392e897cdf9da66391"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="classGtk_1_1Widget.html">Widget</a>* </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Button.html#a18bc83ac500da4a119c67fbf2dd03b76">get_image</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Gets the widget that is currenty set as the image of <em>button</em>. <a href="#a18bc83ac500da4a119c67fbf2dd03b76"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">const <a class="el" href="classGtk_1_1Widget.html">Widget</a>* </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Button.html#a05db2376a19eae4c44379c94def46685">get_image</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Gets the widget that is currenty set as the image of <em>button</em>. <a href="#a05db2376a19eae4c44379c94def46685"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Button.html#a4d4ebee42b3c2255147999f3d385e19c">set_image_position</a> (<a class="el" href="group__gtkmmEnums.html#ga3568edcd04af4a2cbd1eb0195513fe6b">PositionType</a> position)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Sets the position of the image relative to the text inside the button. <a href="#a4d4ebee42b3c2255147999f3d385e19c"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__gtkmmEnums.html#ga3568edcd04af4a2cbd1eb0195513fe6b">PositionType</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Button.html#ab84644d4051e2d3fd5015360f2bef426">get_image_position</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Gets the position of the image relative to the text inside the button. <a href="#ab84644d4051e2d3fd5015360f2bef426"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classGdk_1_1Window.html">Gdk::Window</a> > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Button.html#a2f5566c4321c392a2fe6654b0db9ad0c">get_event_window</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns the button's event window if it is realized, <code>0</code> otherwise. <a href="#a2f5566c4321c392a2fe6654b0db9ad0c"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a>< const <a class="el" href="classGdk_1_1Window.html">Gdk::Window</a> > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Button.html#ab5239dd4a1b3308742d6d3840289b457">get_event_window</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns the button's event window if it is realized, <code>0</code> otherwise. <a href="#ab5239dd4a1b3308742d6d3840289b457"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1SignalProxy0.html">Glib::SignalProxy0</a>< void > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Button.html#acf7a9ec90fa7e4f833af37fe11fb1b18">signal_pressed</a> ()</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1SignalProxy0.html">Glib::SignalProxy0</a>< void > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Button.html#acd22eaf8d862fa3e4fd606a7212d76cf">signal_released</a> ()</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1SignalProxy0.html">Glib::SignalProxy0</a>< void > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Button.html#a515244a851fd9874cc481cdfc5ebf512">signal_clicked</a> ()</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1SignalProxy0.html">Glib::SignalProxy0</a>< void > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Button.html#a99f7eaa8a6aee072e0c08139babf8fa9">signal_enter</a> ()</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1SignalProxy0.html">Glib::SignalProxy0</a>< void > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Button.html#a5b8c8acfe55f9d567f316a53b574690f">signal_leave</a> ()</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1SignalProxy0.html">Glib::SignalProxy0</a>< void > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Button.html#af9af0c8d0dc16d73bad1c2a7f3533485">signal_activate</a> ()</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1PropertyProxy.html">Glib::PropertyProxy</a><br class="typebreak"/>
< <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Button.html#aaacbc200ba99470f78e2c6b440da1145">property_label</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Text of the label widget inside the button, if the button contains a label widget. <a href="#aaacbc200ba99470f78e2c6b440da1145"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1PropertyProxy__ReadOnly.html">Glib::PropertyProxy_ReadOnly</a><br class="typebreak"/>
< <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Button.html#abfcc59b5e18192fa58111b6edadc8958">property_label</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Text of the label widget inside the button, if the button contains a label widget. <a href="#abfcc59b5e18192fa58111b6edadc8958"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1PropertyProxy.html">Glib::PropertyProxy</a>< <a class="el" href="group__gtkmmEnums.html#ga11df7b40133f3cd29b07bd87c969ff42">ReliefStyle</a> > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Button.html#a52bdf1dbe78d515c92ab28d2cf6415ed">property_relief</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">The border relief style. <a href="#a52bdf1dbe78d515c92ab28d2cf6415ed"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1PropertyProxy__ReadOnly.html">Glib::PropertyProxy_ReadOnly</a><br class="typebreak"/>
< <a class="el" href="group__gtkmmEnums.html#ga11df7b40133f3cd29b07bd87c969ff42">ReliefStyle</a> > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Button.html#ad0d3283fb039b08bb0dc84804c1bd23b">property_relief</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">The border relief style. <a href="#ad0d3283fb039b08bb0dc84804c1bd23b"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1PropertyProxy.html">Glib::PropertyProxy</a>< bool > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Button.html#aedc60f765a912ba5652a11512030424e">property_use_stock</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">If set, the label is used to pick a stock item instead of being displayed. <a href="#aedc60f765a912ba5652a11512030424e"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1PropertyProxy__ReadOnly.html">Glib::PropertyProxy_ReadOnly</a><br class="typebreak"/>
< bool > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Button.html#aff09634d48cb0ddf40451d521c2076cf">property_use_stock</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">If set, the label is used to pick a stock item instead of being displayed. <a href="#aff09634d48cb0ddf40451d521c2076cf"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1PropertyProxy.html">Glib::PropertyProxy</a>< bool > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Button.html#a177d1c007b64ba2551f0aa8294630adf">property_focus_on_click</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Whether the button grabs focus when it is clicked with the mouse. <a href="#a177d1c007b64ba2551f0aa8294630adf"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1PropertyProxy__ReadOnly.html">Glib::PropertyProxy_ReadOnly</a><br class="typebreak"/>
< bool > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Button.html#aad8aa9d132968f1f670051b392e0c57a">property_focus_on_click</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Whether the button grabs focus when it is clicked with the mouse. <a href="#aad8aa9d132968f1f670051b392e0c57a"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1PropertyProxy.html">Glib::PropertyProxy</a>< float > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Button.html#aec5ddb71f5989be54943acfe7c486656">property_xalign</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Horizontal position of child in available space. <a href="#aec5ddb71f5989be54943acfe7c486656"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1PropertyProxy__ReadOnly.html">Glib::PropertyProxy_ReadOnly</a><br class="typebreak"/>
< float > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Button.html#af8488aea8dcdc21d13ee0e8a0a173235">property_xalign</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Horizontal position of child in available space. <a href="#af8488aea8dcdc21d13ee0e8a0a173235"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1PropertyProxy.html">Glib::PropertyProxy</a>< float > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Button.html#a05c9e11829874c4c5ccbb931c0bdea48">property_yalign</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Vertical position of child in available space. <a href="#a05c9e11829874c4c5ccbb931c0bdea48"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1PropertyProxy__ReadOnly.html">Glib::PropertyProxy_ReadOnly</a><br class="typebreak"/>
< float > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Button.html#a571936243340d0b1eaba5fc716669907">property_yalign</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Vertical position of child in available space. <a href="#a571936243340d0b1eaba5fc716669907"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1PropertyProxy.html">Glib::PropertyProxy</a><br class="typebreak"/>
< <a class="el" href="classGtk_1_1Widget.html">Gtk::Widget</a>* > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Button.html#a19d95f052d3297a812f7bbddb864c153">property_image</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Child widget to appear next to the button text. <a href="#a19d95f052d3297a812f7bbddb864c153"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1PropertyProxy__ReadOnly.html">Glib::PropertyProxy_ReadOnly</a><br class="typebreak"/>
< <a class="el" href="classGtk_1_1Widget.html">Gtk::Widget</a>* > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Button.html#a1b1a0f32b27c8b0cba6c7404243ba46c">property_image</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Child widget to appear next to the button text. <a href="#a1b1a0f32b27c8b0cba6c7404243ba46c"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1PropertyProxy.html">Glib::PropertyProxy</a>< <a class="el" href="group__gtkmmEnums.html#ga3568edcd04af4a2cbd1eb0195513fe6b">PositionType</a> > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Button.html#ad8a05304b305e20573dc834110f09211">property_image_position</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">The position of the image relative to the text. <a href="#ad8a05304b305e20573dc834110f09211"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1PropertyProxy__ReadOnly.html">Glib::PropertyProxy_ReadOnly</a><br class="typebreak"/>
< <a class="el" href="group__gtkmmEnums.html#ga3568edcd04af4a2cbd1eb0195513fe6b">PositionType</a> > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Button.html#a345dce891d99e571782ea991fa119dcc">property_image_position</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">The position of the image relative to the text. <a href="#a345dce891d99e571782ea991fa119dcc"></a><br/></td></tr>
<tr><td colspan="2"><h2><a name="pro-methods"></a>
Protected Member Functions</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Button.html#ab7cb1b5d352e7ca2d21ea5e8243c0a8f">on_pressed</a> ()</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Button.html#ac10be7bca1f046b9fe1b5e1acf47c1cd">on_released</a> ()</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Button.html#abdd079e988525e00b432190866cdc59f">on_clicked</a> ()</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Button.html#a9de0aa98cfb93f5867d7b2facfbf70ed">on_enter</a> ()</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Button.html#aef824780a36ce218b400e228d46cc21a">on_leave</a> ()</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Button.html#ac5b1ec6552c46f56f10302556372baae">on_activate</a> ()</td></tr>
<tr><td colspan="2"><h2><a name="related"></a>
Related Functions</h2></td></tr>
<tr><td colspan="2">(Note that these are not member functions.) <br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="classGtk_1_1Button.html">Gtk::Button</a>* </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Button.html#a97111e31bc75c69c524fa2a944719a03">wrap</a> (GtkButton* object, bool take_copy=false)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">A <a class="elRef" href="../../../glibmm-2.4/reference/html/namespaceGlib.html#a671306f4a3a0cae5ab4d7a9d54886592">Glib::wrap()</a> method for this object. <a href="#a97111e31bc75c69c524fa2a944719a03"></a><br/></td></tr>
</table>
<hr/><a name="_details"></a><h2>Detailed Description</h2>
<div class="textblock"><p>A widget that creates a signal when clicked on. </p>
<p>This widget is generally used with a signal handler that is called when the button is pressed. It can hold any valid child widget. The most commonly used child is the <a class="el" href="classGtk_1_1Label.html" title="A widget that displays a small to medium amount of text.">Gtk::Label</a>.</p>
<p>The <a class="el" href="classGtk_1_1Button.html" title="A widget that creates a signal when clicked on.">Button</a> widget looks like this: </p>
<div align="center">
<img src="button2.png" alt="button2.png"/>
</div>
</div><hr/><h2>Constructor & Destructor Documentation</h2>
<a class="anchor" id="a188bfc5caf8e3c68d6d80b54186d8961"></a><!-- doxytag: member="Gtk::Button::~Button" ref="a188bfc5caf8e3c68d6d80b54186d8961" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual Gtk::Button::~Button </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td><code> [virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
</div>
</div>
<a class="anchor" id="a122a26893f0efe761712c453b83e6714"></a><!-- doxytag: member="Gtk::Button::Button" ref="a122a26893f0efe761712c453b83e6714" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">Gtk::Button::Button </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Create an empty button. </p>
<p>With an empty button, you can <a class="el" href="classGtk_1_1Container.html#ae5f3b9c32b1b74e7613997843e91f4cc">Gtk::Button::add()</a> a widget such as a Gtk::Pixmap or <a class="el" href="classGtk_1_1Box.html" title="A base class for box containers.">Gtk::Box</a>.</p>
<p>If you just wish to add a <a class="el" href="classGtk_1_1Label.html" title="A widget that displays a small to medium amount of text.">Gtk::Label</a>, you may want to use the Gtk::Button(const Glib::ustring& label) ctor directly instead. </p>
</div>
</div>
<a class="anchor" id="a405a4a0363e4be77a71ed83c8fb61b44"></a><!-- doxytag: member="Gtk::Button::Button" ref="a405a4a0363e4be77a71ed83c8fb61b44" args="(const Glib::ustring &label, bool mnemonic=false)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">Gtk::Button::Button </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> & </td>
<td class="paramname"><em>label</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">bool </td>
<td class="paramname"><em>mnemonic</em> = <code>false</code> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td><code> [explicit]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Simple Push <a class="el" href="classGtk_1_1Button.html" title="A widget that creates a signal when clicked on.">Button</a> with label. </p>
<p>Create a button with the given label inside. You won't be able to add a widget in this button since it already has a <a class="el" href="classGtk_1_1Label.html" title="A widget that displays a small to medium amount of text.">Gtk::Label</a> in it </p>
</div>
</div>
<a class="anchor" id="af44d6e2efbb8342da17f7259626e67cc"></a><!-- doxytag: member="Gtk::Button::Button" ref="af44d6e2efbb8342da17f7259626e67cc" args="(const StockID &stock_id)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">Gtk::Button::Button </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="classGtk_1_1StockID.html">StockID</a>& </td>
<td class="paramname"><em>stock_id</em></td><td>)</td>
<td><code> [explicit]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Creates a new <a class="el" href="classGtk_1_1Button.html" title="A widget that creates a signal when clicked on.">Button</a> containing the image and text from a stock item. </p>
<p><a class="el" href="namespaceGtk_1_1Stock.html">Stock</a> ids have identifiers like <a class="el" href="namespaceGtk_1_1Stock.html#a783d80fdc67520898ed369836f1f3390">Gtk::Stock::OK</a> and <a class="el" href="namespaceGtk_1_1Stock.html#a4cbfe0fbbd18329f560bb225081743c9">Gtk::Stock::APPLY</a>. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">stock_id</td><td>The stock item. </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<hr/><h2>Member Function Documentation</h2>
<a class="anchor" id="af4b7ec50762018dac1ce42b8d1a4a797"></a><!-- doxytag: member="Gtk::Button::clicked" ref="af4b7ec50762018dac1ce42b8d1a4a797" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Gtk::Button::clicked </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
</div>
</div>
<a class="anchor" id="a24a8b5ff7cb9286319643ab5c672ce10"></a><!-- doxytag: member="Gtk::Button::enter" ref="a24a8b5ff7cb9286319643ab5c672ce10" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Gtk::Button::enter </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
</div>
</div>
<a class="anchor" id="a5077c50492734651ff9669f7ef1c8d47"></a><!-- doxytag: member="Gtk::Button::get_alignment" ref="a5077c50492734651ff9669f7ef1c8d47" args="(float &xalign, float &yalign)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Gtk::Button::get_alignment </td>
<td>(</td>
<td class="paramtype">float & </td>
<td class="paramname"><em>xalign</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">float & </td>
<td class="paramname"><em>yalign</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Gets the alignment of the child in the button. </p>
<dl class="since_2_4"><dt><b><a class="el" href="since_2_4.html#_since_2_4000048">Since gtkmm 2.4:</a></b></dt><dd></dd></dl>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">xalign</td><td>Return location for horizontal alignment. </td></tr>
<tr><td class="paramname">yalign</td><td>Return location for vertical alignment. </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a class="anchor" id="ab5239dd4a1b3308742d6d3840289b457"></a><!-- doxytag: member="Gtk::Button::get_event_window" ref="ab5239dd4a1b3308742d6d3840289b457" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a><const <a class="el" href="classGdk_1_1Window.html">Gdk::Window</a>> Gtk::Button::get_event_window </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Returns the button's event window if it is realized, <code>0</code> otherwise. </p>
<p>This function should be rarely needed.</p>
<dl class="since_2_22"><dt><b><a class="el" href="since_2_22.html#_since_2_22000054">Since gtkmm 2.22:</a></b></dt><dd></dd></dl>
<dl class="return"><dt><b>Returns:</b></dt><dd><em>button's</em> event window. </dd></dl>
</div>
</div>
<a class="anchor" id="a2f5566c4321c392a2fe6654b0db9ad0c"></a><!-- doxytag: member="Gtk::Button::get_event_window" ref="a2f5566c4321c392a2fe6654b0db9ad0c" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a><<a class="el" href="classGdk_1_1Window.html">Gdk::Window</a>> Gtk::Button::get_event_window </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Returns the button's event window if it is realized, <code>0</code> otherwise. </p>
<p>This function should be rarely needed.</p>
<dl class="since_2_22"><dt><b><a class="el" href="since_2_22.html#_since_2_22000053">Since gtkmm 2.22:</a></b></dt><dd></dd></dl>
<dl class="return"><dt><b>Returns:</b></dt><dd><em>button's</em> event window. </dd></dl>
</div>
</div>
<a class="anchor" id="ab1800f6488996503da0e80613d52e6fb"></a><!-- doxytag: member="Gtk::Button::get_focus_on_click" ref="ab1800f6488996503da0e80613d52e6fb" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">bool Gtk::Button::get_focus_on_click </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Returns whether the button grabs focus when it is clicked with the mouse. </p>
<p>See <a class="el" href="classGtk_1_1Button.html#aab691cee055c3e2850dcb968f7bf94c9" title="Sets whether the button will grab focus when it is clicked with the mouse.">set_focus_on_click()</a>.</p>
<dl class="since_2_4"><dt><b><a class="el" href="since_2_4.html#_since_2_4000046">Since gtkmm 2.4:</a></b></dt><dd></dd></dl>
<dl class="return"><dt><b>Returns:</b></dt><dd><code>true</code> if the button grabs focus when it is clicked with the mouse. </dd></dl>
</div>
</div>
<a class="anchor" id="a18bc83ac500da4a119c67fbf2dd03b76"></a><!-- doxytag: member="Gtk::Button::get_image" ref="a18bc83ac500da4a119c67fbf2dd03b76" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classGtk_1_1Widget.html">Widget</a>* Gtk::Button::get_image </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Gets the widget that is currenty set as the image of <em>button</em>. </p>
<p>This may have been explicitly set by <a class="el" href="classGtk_1_1Button.html#ac49972018a8ed3392e897cdf9da66391" title="Set the image of button to the given widget.">set_image()</a> or specified as a stock item to the constructor.</p>
<dl class="since_2_6"><dt><b><a class="el" href="since_2_6.html#_since_2_6000041">Since gtkmm 2.6:</a></b></dt><dd></dd></dl>
</div>
</div>
<a class="anchor" id="a05db2376a19eae4c44379c94def46685"></a><!-- doxytag: member="Gtk::Button::get_image" ref="a05db2376a19eae4c44379c94def46685" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">const <a class="el" href="classGtk_1_1Widget.html">Widget</a>* Gtk::Button::get_image </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Gets the widget that is currenty set as the image of <em>button</em>. </p>
<p>This may have been explicitly set by <a class="el" href="classGtk_1_1Button.html#ac49972018a8ed3392e897cdf9da66391" title="Set the image of button to the given widget.">set_image()</a> or specified as a stock item to the constructor.</p>
<dl class="since_2_6"><dt><b><a class="el" href="since_2_6.html#_since_2_6000042">Since gtkmm 2.6:</a></b></dt><dd></dd></dl>
</div>
</div>
<a class="anchor" id="ab84644d4051e2d3fd5015360f2bef426"></a><!-- doxytag: member="Gtk::Button::get_image_position" ref="ab84644d4051e2d3fd5015360f2bef426" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="group__gtkmmEnums.html#ga3568edcd04af4a2cbd1eb0195513fe6b">PositionType</a> Gtk::Button::get_image_position </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Gets the position of the image relative to the text inside the button. </p>
<dl class="since_2_10"><dt><b><a class="el" href="since_2_10.html#_since_2_10000047">Since gtkmm 2.10:</a></b></dt><dd></dd></dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>The position. </dd></dl>
</div>
</div>
<a class="anchor" id="ae377dbb125d9beb6e6fdd5b191f785aa"></a><!-- doxytag: member="Gtk::Button::get_label" ref="ae377dbb125d9beb6e6fdd5b191f785aa" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> Gtk::Button::get_label </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Fetches the text from the label of the button, as set by <a class="el" href="classGtk_1_1Button.html#ad3f9e419fc13a942f679a8545f0d96b6" title="Sets the text of the label of the button to str.">set_label()</a>. </p>
<p>If the label text has not been set the return value will be <code>0</code>. This will be the case if you create an empty button with new() to use as a container. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>The text of the label widget. This string is owned by the widget and must not be modified or freed. </dd></dl>
</div>
</div>
<a class="anchor" id="a2c902cb0c0ac00b26d23a2b04571f9b1"></a><!-- doxytag: member="Gtk::Button::get_relief" ref="a2c902cb0c0ac00b26d23a2b04571f9b1" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="group__gtkmmEnums.html#ga11df7b40133f3cd29b07bd87c969ff42">ReliefStyle</a> Gtk::Button::get_relief </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
</div>
</div>
<a class="anchor" id="aa79490e3b6c63a89d0552790792e1b9b"></a><!-- doxytag: member="Gtk::Button::get_use_stock" ref="aa79490e3b6c63a89d0552790792e1b9b" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">bool Gtk::Button::get_use_stock </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Returns whether the button label is a stock item. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd><code>true</code> if the button label is used to select a stock item instead of being used directly as the label text. </dd></dl>
</div>
</div>
<a class="anchor" id="a6570250c1d48265aae83b8b6b1eb662f"></a><!-- doxytag: member="Gtk::Button::get_use_underline" ref="a6570250c1d48265aae83b8b6b1eb662f" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">bool Gtk::Button::get_use_underline </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Returns whether an embedded underline in the button label indicates a mnemonic. </p>
<p>See <a class="el" href="classGtk_1_1Button.html#a9c5e6c68d197342c751a22e0403c8e95" title="If true, an underline in the text of the button label indicates the next character should be used for...">set_use_underline()</a>. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd><code>true</code> if an embedded underline in the button label indicates the mnemonic accelerator keys. </dd></dl>
</div>
</div>
<a class="anchor" id="aac9db3896fa8b7576c6f3720846faa1c"></a><!-- doxytag: member="Gtk::Button::gobj" ref="aac9db3896fa8b7576c6f3720846faa1c" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">GtkButton* Gtk::Button::gobj </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td><code> [inline]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Provides access to the underlying C GtkObject. </p>
<p>Reimplemented from <a class="el" href="classGtk_1_1Bin.html#a6fef1f41c67a588dd33087ea479e0ad1">Gtk::Bin</a>.</p>
<p>Reimplemented in <a class="el" href="classGtk_1_1CheckButton.html#a9c03c6bb7097d41b6a1d7437259e7cee">Gtk::CheckButton</a>, <a class="el" href="classGtk_1_1ColorButton.html#a1faf17015e5af54cfaa60c263e3b487e">Gtk::ColorButton</a>, <a class="el" href="classGtk_1_1FontButton.html#ad4dae76c16ec6d501816f1a06e9d44b2">Gtk::FontButton</a>, <a class="el" href="classGtk_1_1LinkButton.html#a01e2192f9822c37b815fc6d1d2e33d84">Gtk::LinkButton</a>, <a class="el" href="classGtk_1_1OptionMenu.html#aae1984c3cfd400894e9da3e81fb4c4d0">Gtk::OptionMenu</a>, <a class="el" href="classGtk_1_1RadioButton.html#a43c24cc7bea2c2edf043f4b76c632ee7">Gtk::RadioButton</a>, <a class="el" href="classGtk_1_1ScaleButton.html#abd9b41acbedadf2ae1e4bf96250bf99f">Gtk::ScaleButton</a>, <a class="el" href="classGtk_1_1ToggleButton.html#aaf95f140bb908c7424ce489c8c988993">Gtk::ToggleButton</a>, and <a class="el" href="classGtk_1_1VolumeButton.html#a0da9674c76e5abe87e070c6d987b9605">Gtk::VolumeButton</a>.</p>
</div>
</div>
<a class="anchor" id="a9ea06156c54545902608286d1a0d0e42"></a><!-- doxytag: member="Gtk::Button::gobj" ref="a9ea06156c54545902608286d1a0d0e42" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">const GtkButton* Gtk::Button::gobj </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td> const<code> [inline]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Provides access to the underlying C GtkObject. </p>
<p>Reimplemented from <a class="el" href="classGtk_1_1Bin.html#ad6db11cd388872c6ee36aee075478374">Gtk::Bin</a>.</p>
<p>Reimplemented in <a class="el" href="classGtk_1_1CheckButton.html#a89c2952646c6133413f35f8c38a8f7c1">Gtk::CheckButton</a>, <a class="el" href="classGtk_1_1ColorButton.html#ae852b3e46116fdf4e87e1660ca8bf84e">Gtk::ColorButton</a>, <a class="el" href="classGtk_1_1FontButton.html#a00dbc94dbf245b18d5badf09446d8c03">Gtk::FontButton</a>, <a class="el" href="classGtk_1_1LinkButton.html#a33cb4ef15934e907b80b266ad8c862d2">Gtk::LinkButton</a>, <a class="el" href="classGtk_1_1OptionMenu.html#a7f3da3dbf5f565daa422f126c2b7d86f">Gtk::OptionMenu</a>, <a class="el" href="classGtk_1_1RadioButton.html#a03095fa6bb24ec52d0cceaa3d5ac353d">Gtk::RadioButton</a>, <a class="el" href="classGtk_1_1ScaleButton.html#ac517467566cde32ec931fa95d01964d8">Gtk::ScaleButton</a>, <a class="el" href="classGtk_1_1ToggleButton.html#a64415628d18b8d76da14ce7109e9b6af">Gtk::ToggleButton</a>, and <a class="el" href="classGtk_1_1VolumeButton.html#a12441bec52e8998b606048336f073212">Gtk::VolumeButton</a>.</p>
</div>
</div>
<a class="anchor" id="a4ef2c72ff49b7a51cd51bc34fcf2a9ad"></a><!-- doxytag: member="Gtk::Button::leave" ref="a4ef2c72ff49b7a51cd51bc34fcf2a9ad" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Gtk::Button::leave </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
</div>
</div>
<a class="anchor" id="ac5b1ec6552c46f56f10302556372baae"></a><!-- doxytag: member="Gtk::Button::on_activate" ref="ac5b1ec6552c46f56f10302556372baae" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual void Gtk::Button::on_activate </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td><code> [protected, virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
</div>
</div>
<a class="anchor" id="abdd079e988525e00b432190866cdc59f"></a><!-- doxytag: member="Gtk::Button::on_clicked" ref="abdd079e988525e00b432190866cdc59f" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual void Gtk::Button::on_clicked </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td><code> [protected, virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
</div>
</div>
<a class="anchor" id="a9de0aa98cfb93f5867d7b2facfbf70ed"></a><!-- doxytag: member="Gtk::Button::on_enter" ref="a9de0aa98cfb93f5867d7b2facfbf70ed" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual void Gtk::Button::on_enter </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td><code> [protected, virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
</div>
</div>
<a class="anchor" id="aef824780a36ce218b400e228d46cc21a"></a><!-- doxytag: member="Gtk::Button::on_leave" ref="aef824780a36ce218b400e228d46cc21a" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual void Gtk::Button::on_leave </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td><code> [protected, virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
</div>
</div>
<a class="anchor" id="ab7cb1b5d352e7ca2d21ea5e8243c0a8f"></a><!-- doxytag: member="Gtk::Button::on_pressed" ref="ab7cb1b5d352e7ca2d21ea5e8243c0a8f" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual void Gtk::Button::on_pressed </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td><code> [protected, virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
</div>
</div>
<a class="anchor" id="ac10be7bca1f046b9fe1b5e1acf47c1cd"></a><!-- doxytag: member="Gtk::Button::on_released" ref="ac10be7bca1f046b9fe1b5e1acf47c1cd" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual void Gtk::Button::on_released </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td><code> [protected, virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
</div>
</div>
<a class="anchor" id="a44480a361b5089689676f62d798d8351"></a><!-- doxytag: member="Gtk::Button::pressed" ref="a44480a361b5089689676f62d798d8351" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Gtk::Button::pressed </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
</div>
</div>
<a class="anchor" id="a177d1c007b64ba2551f0aa8294630adf"></a><!-- doxytag: member="Gtk::Button::property_focus_on_click" ref="a177d1c007b64ba2551f0aa8294630adf" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1PropertyProxy.html">Glib::PropertyProxy</a><bool> Gtk::Button::property_focus_on_click </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Whether the button grabs focus when it is clicked with the mouse. </p>
<p>You rarely need to use properties because there are get_ and set_ methods for almost all of them. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>A PropertyProxy that allows you to get or set the property of the value, or receive notification when the value of the property changes. </dd></dl>
</div>
</div>
<a class="anchor" id="aad8aa9d132968f1f670051b392e0c57a"></a><!-- doxytag: member="Gtk::Button::property_focus_on_click" ref="aad8aa9d132968f1f670051b392e0c57a" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1PropertyProxy__ReadOnly.html">Glib::PropertyProxy_ReadOnly</a><bool> Gtk::Button::property_focus_on_click </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Whether the button grabs focus when it is clicked with the mouse. </p>
<p>You rarely need to use properties because there are get_ and set_ methods for almost all of them. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>A PropertyProxy that allows you to get or set the property of the value, or receive notification when the value of the property changes. </dd></dl>
</div>
</div>
<a class="anchor" id="a19d95f052d3297a812f7bbddb864c153"></a><!-- doxytag: member="Gtk::Button::property_image" ref="a19d95f052d3297a812f7bbddb864c153" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1PropertyProxy.html">Glib::PropertyProxy</a><<a class="el" href="classGtk_1_1Widget.html">Gtk::Widget</a>*> Gtk::Button::property_image </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Child widget to appear next to the button text. </p>
<p>You rarely need to use properties because there are get_ and set_ methods for almost all of them. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>A PropertyProxy that allows you to get or set the property of the value, or receive notification when the value of the property changes. </dd></dl>
</div>
</div>
<a class="anchor" id="a1b1a0f32b27c8b0cba6c7404243ba46c"></a><!-- doxytag: member="Gtk::Button::property_image" ref="a1b1a0f32b27c8b0cba6c7404243ba46c" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1PropertyProxy__ReadOnly.html">Glib::PropertyProxy_ReadOnly</a><<a class="el" href="classGtk_1_1Widget.html">Gtk::Widget</a>*> Gtk::Button::property_image </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Child widget to appear next to the button text. </p>
<p>You rarely need to use properties because there are get_ and set_ methods for almost all of them. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>A PropertyProxy that allows you to get or set the property of the value, or receive notification when the value of the property changes. </dd></dl>
</div>
</div>
<a class="anchor" id="a345dce891d99e571782ea991fa119dcc"></a><!-- doxytag: member="Gtk::Button::property_image_position" ref="a345dce891d99e571782ea991fa119dcc" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1PropertyProxy__ReadOnly.html">Glib::PropertyProxy_ReadOnly</a><<a class="el" href="group__gtkmmEnums.html#ga3568edcd04af4a2cbd1eb0195513fe6b">PositionType</a>> Gtk::Button::property_image_position </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>The position of the image relative to the text. </p>
<p>You rarely need to use properties because there are get_ and set_ methods for almost all of them. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>A PropertyProxy that allows you to get or set the property of the value, or receive notification when the value of the property changes. </dd></dl>
</div>
</div>
<a class="anchor" id="ad8a05304b305e20573dc834110f09211"></a><!-- doxytag: member="Gtk::Button::property_image_position" ref="ad8a05304b305e20573dc834110f09211" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1PropertyProxy.html">Glib::PropertyProxy</a><<a class="el" href="group__gtkmmEnums.html#ga3568edcd04af4a2cbd1eb0195513fe6b">PositionType</a>> Gtk::Button::property_image_position </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>The position of the image relative to the text. </p>
<p>You rarely need to use properties because there are get_ and set_ methods for almost all of them. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>A PropertyProxy that allows you to get or set the property of the value, or receive notification when the value of the property changes. </dd></dl>
</div>
</div>
<a class="anchor" id="aaacbc200ba99470f78e2c6b440da1145"></a><!-- doxytag: member="Gtk::Button::property_label" ref="aaacbc200ba99470f78e2c6b440da1145" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1PropertyProxy.html">Glib::PropertyProxy</a><<a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a>> Gtk::Button::property_label </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Text of the label widget inside the button, if the button contains a label widget. </p>
<p>You rarely need to use properties because there are get_ and set_ methods for almost all of them. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>A PropertyProxy that allows you to get or set the property of the value, or receive notification when the value of the property changes. </dd></dl>
</div>
</div>
<a class="anchor" id="abfcc59b5e18192fa58111b6edadc8958"></a><!-- doxytag: member="Gtk::Button::property_label" ref="abfcc59b5e18192fa58111b6edadc8958" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1PropertyProxy__ReadOnly.html">Glib::PropertyProxy_ReadOnly</a><<a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a>> Gtk::Button::property_label </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Text of the label widget inside the button, if the button contains a label widget. </p>
<p>You rarely need to use properties because there are get_ and set_ methods for almost all of them. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>A PropertyProxy that allows you to get or set the property of the value, or receive notification when the value of the property changes. </dd></dl>
</div>
</div>
<a class="anchor" id="a52bdf1dbe78d515c92ab28d2cf6415ed"></a><!-- doxytag: member="Gtk::Button::property_relief" ref="a52bdf1dbe78d515c92ab28d2cf6415ed" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1PropertyProxy.html">Glib::PropertyProxy</a><<a class="el" href="group__gtkmmEnums.html#ga11df7b40133f3cd29b07bd87c969ff42">ReliefStyle</a>> Gtk::Button::property_relief </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>The border relief style. </p>
<p>You rarely need to use properties because there are get_ and set_ methods for almost all of them. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>A PropertyProxy that allows you to get or set the property of the value, or receive notification when the value of the property changes. </dd></dl>
</div>
</div>
<a class="anchor" id="ad0d3283fb039b08bb0dc84804c1bd23b"></a><!-- doxytag: member="Gtk::Button::property_relief" ref="ad0d3283fb039b08bb0dc84804c1bd23b" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1PropertyProxy__ReadOnly.html">Glib::PropertyProxy_ReadOnly</a><<a class="el" href="group__gtkmmEnums.html#ga11df7b40133f3cd29b07bd87c969ff42">ReliefStyle</a>> Gtk::Button::property_relief </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>The border relief style. </p>
<p>You rarely need to use properties because there are get_ and set_ methods for almost all of them. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>A PropertyProxy that allows you to get or set the property of the value, or receive notification when the value of the property changes. </dd></dl>
</div>
</div>
<a class="anchor" id="aedc60f765a912ba5652a11512030424e"></a><!-- doxytag: member="Gtk::Button::property_use_stock" ref="aedc60f765a912ba5652a11512030424e" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1PropertyProxy.html">Glib::PropertyProxy</a><bool> Gtk::Button::property_use_stock </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>If set, the label is used to pick a stock item instead of being displayed. </p>
<p>You rarely need to use properties because there are get_ and set_ methods for almost all of them. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>A PropertyProxy that allows you to get or set the property of the value, or receive notification when the value of the property changes. </dd></dl>
</div>
</div>
<a class="anchor" id="aff09634d48cb0ddf40451d521c2076cf"></a><!-- doxytag: member="Gtk::Button::property_use_stock" ref="aff09634d48cb0ddf40451d521c2076cf" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1PropertyProxy__ReadOnly.html">Glib::PropertyProxy_ReadOnly</a><bool> Gtk::Button::property_use_stock </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>If set, the label is used to pick a stock item instead of being displayed. </p>
<p>You rarely need to use properties because there are get_ and set_ methods for almost all of them. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>A PropertyProxy that allows you to get or set the property of the value, or receive notification when the value of the property changes. </dd></dl>
</div>
</div>
<a class="anchor" id="af8488aea8dcdc21d13ee0e8a0a173235"></a><!-- doxytag: member="Gtk::Button::property_xalign" ref="af8488aea8dcdc21d13ee0e8a0a173235" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1PropertyProxy__ReadOnly.html">Glib::PropertyProxy_ReadOnly</a><float> Gtk::Button::property_xalign </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Horizontal position of child in available space. </p>
<p>0.0 is left aligned, 1.0 is right aligned.</p>
<p>You rarely need to use properties because there are get_ and set_ methods for almost all of them. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>A PropertyProxy that allows you to get or set the property of the value, or receive notification when the value of the property changes. </dd></dl>
</div>
</div>
<a class="anchor" id="aec5ddb71f5989be54943acfe7c486656"></a><!-- doxytag: member="Gtk::Button::property_xalign" ref="aec5ddb71f5989be54943acfe7c486656" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1PropertyProxy.html">Glib::PropertyProxy</a><float> Gtk::Button::property_xalign </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Horizontal position of child in available space. </p>
<p>0.0 is left aligned, 1.0 is right aligned.</p>
<p>You rarely need to use properties because there are get_ and set_ methods for almost all of them. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>A PropertyProxy that allows you to get or set the property of the value, or receive notification when the value of the property changes. </dd></dl>
</div>
</div>
<a class="anchor" id="a571936243340d0b1eaba5fc716669907"></a><!-- doxytag: member="Gtk::Button::property_yalign" ref="a571936243340d0b1eaba5fc716669907" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1PropertyProxy__ReadOnly.html">Glib::PropertyProxy_ReadOnly</a><float> Gtk::Button::property_yalign </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Vertical position of child in available space. </p>
<p>0.0 is top aligned, 1.0 is bottom aligned.</p>
<p>You rarely need to use properties because there are get_ and set_ methods for almost all of them. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>A PropertyProxy that allows you to get or set the property of the value, or receive notification when the value of the property changes. </dd></dl>
</div>
</div>
<a class="anchor" id="a05c9e11829874c4c5ccbb931c0bdea48"></a><!-- doxytag: member="Gtk::Button::property_yalign" ref="a05c9e11829874c4c5ccbb931c0bdea48" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1PropertyProxy.html">Glib::PropertyProxy</a><float> Gtk::Button::property_yalign </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Vertical position of child in available space. </p>
<p>0.0 is top aligned, 1.0 is bottom aligned.</p>
<p>You rarely need to use properties because there are get_ and set_ methods for almost all of them. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>A PropertyProxy that allows you to get or set the property of the value, or receive notification when the value of the property changes. </dd></dl>
</div>
</div>
<a class="anchor" id="afc33139cc82d05b108d791d63fceeecb"></a><!-- doxytag: member="Gtk::Button::released" ref="afc33139cc82d05b108d791d63fceeecb" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Gtk::Button::released </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
</div>
</div>
<a class="anchor" id="a7b204372b3ee1395290cfad7033c08fb"></a><!-- doxytag: member="Gtk::Button::set_alignment" ref="a7b204372b3ee1395290cfad7033c08fb" args="(float xalign, float yalign)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Gtk::Button::set_alignment </td>
<td>(</td>
<td class="paramtype">float </td>
<td class="paramname"><em>xalign</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">float </td>
<td class="paramname"><em>yalign</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Sets the alignment of the child. </p>
<p>This property has no effect unless the child is a <a class="el" href="classGtk_1_1Misc.html" title="A base class for widgets with alignments and padding.">Gtk::Misc</a> or a Gtk::Aligment.</p>
<dl class="since_2_4"><dt><b><a class="el" href="since_2_4.html#_since_2_4000047">Since gtkmm 2.4:</a></b></dt><dd></dd></dl>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">xalign</td><td>The horizontal position of the child, 0.0 is left aligned, 1.0 is right aligned. </td></tr>
<tr><td class="paramname">yalign</td><td>The vertical position of the child, 0.0 is top aligned, 1.0 is bottom aligned. </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a class="anchor" id="aab691cee055c3e2850dcb968f7bf94c9"></a><!-- doxytag: member="Gtk::Button::set_focus_on_click" ref="aab691cee055c3e2850dcb968f7bf94c9" args="(bool focus_on_click=true)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Gtk::Button::set_focus_on_click </td>
<td>(</td>
<td class="paramtype">bool </td>
<td class="paramname"><em>focus_on_click</em> = <code>true</code></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Sets whether the button will grab focus when it is clicked with the mouse. </p>
<p>Making mouse clicks not grab focus is useful in places like toolbars where you don't want the keyboard focus removed from the main area of the application.</p>
<dl class="since_2_4"><dt><b><a class="el" href="since_2_4.html#_since_2_4000045">Since gtkmm 2.4:</a></b></dt><dd></dd></dl>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">focus_on_click</td><td>Whether the button grabs focus when clicked with the mouse. </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a class="anchor" id="ac49972018a8ed3392e897cdf9da66391"></a><!-- doxytag: member="Gtk::Button::set_image" ref="ac49972018a8ed3392e897cdf9da66391" args="(Widget &image)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Gtk::Button::set_image </td>
<td>(</td>
<td class="paramtype"><a class="el" href="classGtk_1_1Widget.html">Widget</a>& </td>
<td class="paramname"><em>image</em></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Set the image of <em>button</em> to the given widget. </p>
<p>Note that it depends on the <a class="el" href="classGtk_1_1Settings.html" title="Sharing settings between applications.">Gtk::Settings</a>:gtk-button-images setting whether the image will be displayed or not, you don't have to call <a class="el" href="classGtk_1_1Widget.html#aa791d86a0bb3658e378e81d731dd0121" title="Flags a widget to be displayed.">Gtk::Widget::show()</a> on <em>image</em> yourself.</p>
<dl class="since_2_6"><dt><b><a class="el" href="since_2_6.html#_since_2_6000040">Since gtkmm 2.6:</a></b></dt><dd></dd></dl>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">image</td><td>A widget to set as the image for the button. </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a class="anchor" id="a4d4ebee42b3c2255147999f3d385e19c"></a><!-- doxytag: member="Gtk::Button::set_image_position" ref="a4d4ebee42b3c2255147999f3d385e19c" args="(PositionType position)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Gtk::Button::set_image_position </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__gtkmmEnums.html#ga3568edcd04af4a2cbd1eb0195513fe6b">PositionType</a> </td>
<td class="paramname"><em>position</em></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Sets the position of the image relative to the text inside the button. </p>
<dl class="since_2_10"><dt><b><a class="el" href="since_2_10.html#_since_2_10000046">Since gtkmm 2.10:</a></b></dt><dd></dd></dl>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">position</td><td>The position. </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a class="anchor" id="ad3f9e419fc13a942f679a8545f0d96b6"></a><!-- doxytag: member="Gtk::Button::set_label" ref="ad3f9e419fc13a942f679a8545f0d96b6" args="(const Glib::ustring &label)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Gtk::Button::set_label </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> & </td>
<td class="paramname"><em>label</em></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Sets the text of the label of the button to <em>str</em>. </p>
<p>This text is also used to select the stock item if <a class="el" href="classGtk_1_1Button.html#ad50fe8ec5243d13e8d146c54d12cf5a8" title="If true, the label set on the button is used as a stock id to select the stock item for the button...">set_use_stock()</a> is used.</p>
<p>This will also clear any previously set labels. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">label</td><td>A string. </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a class="anchor" id="aaeee84797391945df559ebe1c0b88c1e"></a><!-- doxytag: member="Gtk::Button::set_relief" ref="aaeee84797391945df559ebe1c0b88c1e" args="(ReliefStyle newstyle)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Gtk::Button::set_relief </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__gtkmmEnums.html#ga11df7b40133f3cd29b07bd87c969ff42">ReliefStyle</a> </td>
<td class="paramname"><em>newstyle</em></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
</div>
</div>
<a class="anchor" id="ad50fe8ec5243d13e8d146c54d12cf5a8"></a><!-- doxytag: member="Gtk::Button::set_use_stock" ref="ad50fe8ec5243d13e8d146c54d12cf5a8" args="(bool use_stock=true)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Gtk::Button::set_use_stock </td>
<td>(</td>
<td class="paramtype">bool </td>
<td class="paramname"><em>use_stock</em> = <code>true</code></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>If <code>true</code>, the label set on the button is used as a stock id to select the stock item for the button. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">use_stock</td><td><code>true</code> if the button should use a stock item. </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a class="anchor" id="a9c5e6c68d197342c751a22e0403c8e95"></a><!-- doxytag: member="Gtk::Button::set_use_underline" ref="a9c5e6c68d197342c751a22e0403c8e95" args="(bool use_underline=true)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Gtk::Button::set_use_underline </td>
<td>(</td>
<td class="paramtype">bool </td>
<td class="paramname"><em>use_underline</em> = <code>true</code></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>If true, an underline in the text of the button label indicates the next character should be used for the mnemonic accelerator key. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">use_underline</td><td><code>true</code> if underlines in the text indicate mnemonics. </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a class="anchor" id="af9af0c8d0dc16d73bad1c2a7f3533485"></a><!-- doxytag: member="Gtk::Button::signal_activate" ref="af9af0c8d0dc16d73bad1c2a7f3533485" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1SignalProxy0.html">Glib::SignalProxy0</a>< void > Gtk::Button::signal_activate </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<dl class="user"><dt><b>Prototype:</b></dt><dd><code>void on_my_activate()</code> </dd></dl>
</div>
</div>
<a class="anchor" id="a515244a851fd9874cc481cdfc5ebf512"></a><!-- doxytag: member="Gtk::Button::signal_clicked" ref="a515244a851fd9874cc481cdfc5ebf512" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1SignalProxy0.html">Glib::SignalProxy0</a>< void > Gtk::Button::signal_clicked </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<dl class="user"><dt><b>Prototype:</b></dt><dd><code>void on_my_clicked()</code> </dd></dl>
</div>
</div>
<a class="anchor" id="a99f7eaa8a6aee072e0c08139babf8fa9"></a><!-- doxytag: member="Gtk::Button::signal_enter" ref="a99f7eaa8a6aee072e0c08139babf8fa9" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1SignalProxy0.html">Glib::SignalProxy0</a>< void > Gtk::Button::signal_enter </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<dl class="user"><dt><b>Prototype:</b></dt><dd><code>void on_my_enter()</code> </dd></dl>
</div>
</div>
<a class="anchor" id="a5b8c8acfe55f9d567f316a53b574690f"></a><!-- doxytag: member="Gtk::Button::signal_leave" ref="a5b8c8acfe55f9d567f316a53b574690f" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1SignalProxy0.html">Glib::SignalProxy0</a>< void > Gtk::Button::signal_leave </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<dl class="user"><dt><b>Prototype:</b></dt><dd><code>void on_my_leave()</code> </dd></dl>
</div>
</div>
<a class="anchor" id="acf7a9ec90fa7e4f833af37fe11fb1b18"></a><!-- doxytag: member="Gtk::Button::signal_pressed" ref="acf7a9ec90fa7e4f833af37fe11fb1b18" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1SignalProxy0.html">Glib::SignalProxy0</a>< void > Gtk::Button::signal_pressed </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<dl class="user"><dt><b>Prototype:</b></dt><dd><code>void on_my_pressed()</code> </dd></dl>
</div>
</div>
<a class="anchor" id="acd22eaf8d862fa3e4fd606a7212d76cf"></a><!-- doxytag: member="Gtk::Button::signal_released" ref="acd22eaf8d862fa3e4fd606a7212d76cf" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1SignalProxy0.html">Glib::SignalProxy0</a>< void > Gtk::Button::signal_released </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<dl class="user"><dt><b>Prototype:</b></dt><dd><code>void on_my_released()</code> </dd></dl>
</div>
</div>
<hr/><h2>Friends And Related Function Documentation</h2>
<a class="anchor" id="a97111e31bc75c69c524fa2a944719a03"></a><!-- doxytag: member="Gtk::Button::wrap" ref="a97111e31bc75c69c524fa2a944719a03" args="(GtkButton *object, bool take_copy=false)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classGtk_1_1Button.html">Gtk::Button</a>* wrap </td>
<td>(</td>
<td class="paramtype">GtkButton * </td>
<td class="paramname"><em>object</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">bool </td>
<td class="paramname"><em>take_copy</em> = <code>false</code> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td><code> [related]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>A <a class="elRef" href="../../../glibmm-2.4/reference/html/namespaceGlib.html#a671306f4a3a0cae5ab4d7a9d54886592">Glib::wrap()</a> method for this object. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">object</td><td>The C instance. </td></tr>
<tr><td class="paramname">take_copy</td><td>False if the result should take ownership of the C instance. True if it should take a new copy or ref. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>A C++ instance that wraps this C instance. </dd></dl>
</div>
</div>
<hr/>The documentation for this class was generated from the following file:<ul>
<li>gtkmm/button.h</li>
</ul>
</div>
<hr class="footer"/><address class="footer"><small>Generated on Tue Jun 25 2013 for gtkmm by 
<a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.7.3 </small></address>
</body>
</html>
