<!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::CheckMenuItem 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.6.1 -->
<div class="navigation" id="top">
<div class="tabs">
<ul>
<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 class="tabs">
<ul>
<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="hierarchy.html"><span>Class Hierarchy</span></a></li>
<li><a href="functions.html"><span>Class Members</span></a></li>
</ul>
</div>
<div class="navpath"><a class="el" href="namespaceGtk.html">Gtk</a>::<a class="el" href="classGtk_1_1CheckMenuItem.html">CheckMenuItem</a>
</div>
</div>
<div class="contents">
<h1>Gtk::CheckMenuItem Class Reference<br/>
<small>
[<a class="el" href="group__Widgets.html">Widgets</a>, <a class="el" href="group__Menus.html">Menu classes</a>]</small>
</h1><!-- doxytag: class="Gtk::CheckMenuItem" --><!-- doxytag: inherits="Gtk::MenuItem" -->
<p>A menu item that maintains the state of a boolean value in addition to a <a class="el" href="classGtk_1_1MenuItem.html" title="Child item for menus.">Gtk::MenuItem</a>'s usual role in activating application code. <a href="#_details">More...</a></p>
<p>Inherits <a class="el" href="classGtk_1_1MenuItem.html">Gtk::MenuItem</a>.</p>
<p>Inherited by <a class="el" href="classGtk_1_1RadioMenuItem.html">Gtk::RadioMenuItem</a>.</p>
<div class="dynheader">
Collaboration diagram for Gtk::CheckMenuItem:</div>
<div class="dynsection">
<div class="center"><img src="classGtk_1_1CheckMenuItem__coll__graph.png" border="0" usemap="#Gtk_1_1CheckMenuItem_coll__map" alt="Collaboration graph"/></div>
<map name="Gtk_1_1CheckMenuItem_coll__map" id="Gtk_1_1CheckMenuItem_coll__map">
<area shape="rect" href="classGtk_1_1MenuItem.html" title="Child item for menus." alt="" coords="101,677,208,707"/><area shape="rect" href="classGtk_1_1Item.html" title="This class should be considered as a virtual base class." alt="" coords="52,581,127,611"/><area shape="rect" href="classGtk_1_1Bin.html" title="A container with just one child." alt="" coords="55,485,124,515"/><area shape="rect" href="classGtk_1_1Container.html" title="Abstract container class." alt="" coords="37,405,141,435"/><area shape="rect" href="classGtk_1_1Widget.html" title="Abstract Widget (Base class for all widgets)." alt="" coords="44,325,135,355"/><area shape="rect" href="classGtk_1_1Object.html" title="Gtk::Object is the base class for all widgets, and for a few non-widget objects such..." alt="" coords="5,245,93,275"/><area shape="rect" href="../../../glibmm-2.4/reference/html/classGlib_1_1Object.html" title="Glib::Object" alt="" coords="8,165,99,195"/><area shape="rect" href="../../../glibmm-2.4/reference/html/classGlib_1_1ObjectBase.html" title="Glib::ObjectBase" alt="" coords="64,85,184,115"/><area shape="rect" href="../../../glibmm-2.4/reference/html/classGlib_1_1Interface.html" title="Glib::Interface" alt="" coords="123,165,227,195"/><area shape="rect" href="../../../libsigc++-2.0/reference/html/structsigc_1_1trackable.html" title="sigc::trackable" alt="" coords="71,5,177,35"/><area shape="rect" href="classAtk_1_1Implementor.html" title="Atk::Implementor" alt="" coords="117,245,237,275"/><area shape="rect" href="classGtk_1_1AccelKey.html" title="Defines accelerator key combinations." alt="" coords="151,581,255,611"/><area shape="rect" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html" title="Glib::ustring" alt="" coords="157,485,248,515"/></map>
<center><span class="legend">[<a href="graph_legend.html">legend</a>]</span></center></div>
<p><a href="classGtk_1_1CheckMenuItem-members.html">List of all members.</a></p>
<table border="0" cellpadding="0" cellspacing="0">
<tr><td colspan="2"><h2>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_1CheckMenuItem.html#a15230103bbc42f6c7d2a31cd296bf401">~CheckMenuItem</a> ()</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">GtkCheckMenuItem* </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1CheckMenuItem.html#ae1cd8058cbedb6d2b10c48126aa7cd0b">gobj</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Provides access to the underlying C GtkObject. <a href="#ae1cd8058cbedb6d2b10c48126aa7cd0b"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">const GtkCheckMenuItem* </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1CheckMenuItem.html#a303cc14dedc6089f93eb7a1eb0ef9ea1">gobj</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Provides access to the underlying C GtkObject. <a href="#a303cc14dedc6089f93eb7a1eb0ef9ea1"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1CheckMenuItem.html#afe71276f497fa41438e9caf056364ebe">CheckMenuItem</a> ()</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1CheckMenuItem.html#a89dd5307f2dc327a666b34c42737ea02">CheckMenuItem</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="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1CheckMenuItem.html#ab2b9dca0ea2dbbbf9ebf5c52025d7656">set_active</a> (bool state=true)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1CheckMenuItem.html#a0df0c0cd1c4236b80f384628cb5bdd1a">get_active</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns whether the check menu item is active. <a href="#a0df0c0cd1c4236b80f384628cb5bdd1a"></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_1CheckMenuItem.html#abfd72929d9158bcf0d59ea73c43c1d28">toggled</a> ()</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1CheckMenuItem.html#a36b7bce27c9be0fc73667486692ac507">set_inconsistent</a> (bool setting=true)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">If the user has selected a range of elements (such as some text or spreadsheet cells) that are affected by a boolean setting, and the current values in that range are inconsistent, you may want to display the check in an "in between" state. <a href="#a36b7bce27c9be0fc73667486692ac507"></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_1CheckMenuItem.html#a07ff5a33b20d3b5babcdc7cda4f04a08">get_inconsistent</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Retrieves the value set by <a class="el" href="classGtk_1_1CheckMenuItem.html#a36b7bce27c9be0fc73667486692ac507" title="If the user has selected a range of elements (such as some text or spreadsheet cells)...">set_inconsistent()</a>. <a href="#a07ff5a33b20d3b5babcdc7cda4f04a08"></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_1CheckMenuItem.html#a6bc19fef98ea18c634398a654062e4c4">set_draw_as_radio</a> (bool draw_as_radio=true)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Sets whether <em>check_menu_item</em> is drawn like a <a class="el" href="classGtk_1_1RadioMenuItem.html" title="A CheckMenuItem that belongs to a group.">Gtk::RadioMenuItem</a>. <a href="#a6bc19fef98ea18c634398a654062e4c4"></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_1CheckMenuItem.html#a28761f5bca1ec7e28d21c56fa2b5f993">get_draw_as_radio</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns whether <em>check_menu_item</em> looks like a <a class="el" href="classGtk_1_1RadioMenuItem.html" title="A CheckMenuItem that belongs to a group.">Gtk::RadioMenuItem</a>. <a href="#a28761f5bca1ec7e28d21c56fa2b5f993"></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_1CheckMenuItem.html#a91a132cee0317fc3429b78310ddcc46f">signal_toggled</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Triggered when the item changes state (Note : changing the item's state with <a class="el" href="classGtk_1_1CheckMenuItem.html#ab2b9dca0ea2dbbbf9ebf5c52025d7656">set_active()</a> will also trigger this signal). <a href="#a91a132cee0317fc3429b78310ddcc46f"></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_1CheckMenuItem.html#a0abd9bbaee271a248334398d3e53e5b0">property_active</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Whether the menu item is checked. <a href="#a0abd9bbaee271a248334398d3e53e5b0"></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_1CheckMenuItem.html#a2279f36eb8eb5bef364a150b9b021553">property_active</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Whether the menu item is checked. <a href="#a2279f36eb8eb5bef364a150b9b021553"></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_1CheckMenuItem.html#a1738cb2a515afb19625e143c2c66e7ee">property_inconsistent</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Whether to display an 'inconsistent' state. <a href="#a1738cb2a515afb19625e143c2c66e7ee"></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_1CheckMenuItem.html#a7aecfd1f61e3b117ba69a34b4cce19ad">property_inconsistent</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Whether to display an 'inconsistent' state. <a href="#a7aecfd1f61e3b117ba69a34b4cce19ad"></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_1CheckMenuItem.html#a9c8cc22364a1adb5cacbf2f16f7ffe14">property_draw_as_radio</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Whether the menu item looks like a radio menu item. <a href="#a9c8cc22364a1adb5cacbf2f16f7ffe14"></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_1CheckMenuItem.html#adbd033770269d030c4ee580d24a7fc0f">property_draw_as_radio</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Whether the menu item looks like a radio menu item. <a href="#adbd033770269d030c4ee580d24a7fc0f"></a><br/></td></tr>
<tr><td colspan="2"><h2>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_1CheckMenuItem.html#aaed9d53fc1ee69bb7d65511c24303dac">on_toggled</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_1CheckMenuItem.html#a60f2d90cd53a5d08da1e58e8b19a264c">draw_indicator_vfunc</a> (GdkRectangle* area)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Triggered when the item is redrawn (e.g.after being toggled) Overload this signal if you want to implement your own check item look. <a href="#a60f2d90cd53a5d08da1e58e8b19a264c"></a><br/></td></tr>
<tr><td colspan="2"><h2>Related Functions</h2></td></tr>
<tr><td colspan="2"><p>(Note that these are not member functions.) </p>
<br/><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="classGtk_1_1CheckMenuItem.html">Gtk::CheckMenuItem</a>* </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1CheckMenuItem.html#af338c70b431ea56cc0797e015e3d8001">wrap</a> (GtkCheckMenuItem* 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="#af338c70b431ea56cc0797e015e3d8001"></a><br/></td></tr>
</table>
<hr/><a name="_details"></a><h2>Detailed Description</h2>
<p>A menu item that maintains the state of a boolean value in addition to a <a class="el" href="classGtk_1_1MenuItem.html" title="Child item for menus.">Gtk::MenuItem</a>'s usual role in activating application code. </p>
<p>A check box indicating the state of the boolean value is displayed at the left side of the <a class="el" href="classGtk_1_1MenuItem.html" title="Child item for menus.">Gtk::MenuItem</a>. Activating the <a class="el" href="classGtk_1_1MenuItem.html" title="Child item for menus.">Gtk::MenuItem</a> toggles the value. </p>
<hr/><h2>Constructor & Destructor Documentation</h2>
<a class="anchor" id="a15230103bbc42f6c7d2a31cd296bf401"></a><!-- doxytag: member="Gtk::CheckMenuItem::~CheckMenuItem" ref="a15230103bbc42f6c7d2a31cd296bf401" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual Gtk::CheckMenuItem::~CheckMenuItem </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="afe71276f497fa41438e9caf056364ebe"></a><!-- doxytag: member="Gtk::CheckMenuItem::CheckMenuItem" ref="afe71276f497fa41438e9caf056364ebe" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">Gtk::CheckMenuItem::CheckMenuItem </td>
<td>(</td>
<td class="paramname"></td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
</div>
</div>
<a class="anchor" id="a89dd5307f2dc327a666b34c42737ea02"></a><!-- doxytag: member="Gtk::CheckMenuItem::CheckMenuItem" ref="a89dd5307f2dc327a666b34c42737ea02" args="(const Glib::ustring &label, bool mnemonic=false)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">Gtk::CheckMenuItem::CheckMenuItem </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><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td><code> [explicit]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
</div>
</div>
<hr/><h2>Member Function Documentation</h2>
<a class="anchor" id="a60f2d90cd53a5d08da1e58e8b19a264c"></a><!-- doxytag: member="Gtk::CheckMenuItem::draw_indicator_vfunc" ref="a60f2d90cd53a5d08da1e58e8b19a264c" args="(GdkRectangle *area)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual void Gtk::CheckMenuItem::draw_indicator_vfunc </td>
<td>(</td>
<td class="paramtype">GdkRectangle * </td>
<td class="paramname"> <em>area</em></td>
<td> ) </td>
<td><code> [protected, virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Triggered when the item is redrawn (e.g.after being toggled) Overload this signal if you want to implement your own check item look. </p>
<p>Otherwise, you most likely don't care about it. The GdkRectangle specifies the area of the widget which will get redrawn. </p>
</div>
</div>
<a class="anchor" id="a0df0c0cd1c4236b80f384628cb5bdd1a"></a><!-- doxytag: member="Gtk::CheckMenuItem::get_active" ref="a0df0c0cd1c4236b80f384628cb5bdd1a" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">bool Gtk::CheckMenuItem::get_active </td>
<td>(</td>
<td class="paramname"></td>
<td> ) </td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Returns whether the check menu item is active. </p>
<p>See <a class="el" href="classGtk_1_1CheckMenuItem.html#ab2b9dca0ea2dbbbf9ebf5c52025d7656">set_active()</a>. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd><code>true</code> if the menu item is checked. </dd></dl>
</div>
</div>
<a class="anchor" id="a28761f5bca1ec7e28d21c56fa2b5f993"></a><!-- doxytag: member="Gtk::CheckMenuItem::get_draw_as_radio" ref="a28761f5bca1ec7e28d21c56fa2b5f993" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">bool Gtk::CheckMenuItem::get_draw_as_radio </td>
<td>(</td>
<td class="paramname"></td>
<td> ) </td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Returns whether <em>check_menu_item</em> looks like a <a class="el" href="classGtk_1_1RadioMenuItem.html" title="A CheckMenuItem that belongs to a group.">Gtk::RadioMenuItem</a>. </p>
<dl class="since_2_4"><dt><b><a class="el" href="since_2_4.html#_since_2_4000060">Since gtkmm 2.4:</a></b></dt><dd></dd></dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>Whether <em>check_menu_item</em> looks like a <a class="el" href="classGtk_1_1RadioMenuItem.html" title="A CheckMenuItem that belongs to a group.">Gtk::RadioMenuItem</a>. </dd></dl>
</div>
</div>
<a class="anchor" id="a07ff5a33b20d3b5babcdc7cda4f04a08"></a><!-- doxytag: member="Gtk::CheckMenuItem::get_inconsistent" ref="a07ff5a33b20d3b5babcdc7cda4f04a08" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">bool Gtk::CheckMenuItem::get_inconsistent </td>
<td>(</td>
<td class="paramname"></td>
<td> ) </td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Retrieves the value set by <a class="el" href="classGtk_1_1CheckMenuItem.html#a36b7bce27c9be0fc73667486692ac507" title="If the user has selected a range of elements (such as some text or spreadsheet cells)...">set_inconsistent()</a>. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd><code>true</code> if inconsistent. </dd></dl>
</div>
</div>
<a class="anchor" id="a303cc14dedc6089f93eb7a1eb0ef9ea1"></a><!-- doxytag: member="Gtk::CheckMenuItem::gobj" ref="a303cc14dedc6089f93eb7a1eb0ef9ea1" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">const GtkCheckMenuItem* Gtk::CheckMenuItem::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_1MenuItem.html#a0a65458b00dcc51d4c70402aa3fb0d75">Gtk::MenuItem</a>.</p>
<p>Reimplemented in <a class="el" href="classGtk_1_1RadioMenuItem.html#a4e56cc44616edb1533dfcbe95705dc24">Gtk::RadioMenuItem</a>.</p>
</div>
</div>
<a class="anchor" id="ae1cd8058cbedb6d2b10c48126aa7cd0b"></a><!-- doxytag: member="Gtk::CheckMenuItem::gobj" ref="ae1cd8058cbedb6d2b10c48126aa7cd0b" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">GtkCheckMenuItem* Gtk::CheckMenuItem::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_1MenuItem.html#aa83fe08a8b6c5e36a7c464c5f2faf946">Gtk::MenuItem</a>.</p>
<p>Reimplemented in <a class="el" href="classGtk_1_1RadioMenuItem.html#aabd8e463294ac590ba329a79bda1820b">Gtk::RadioMenuItem</a>.</p>
</div>
</div>
<a class="anchor" id="aaed9d53fc1ee69bb7d65511c24303dac"></a><!-- doxytag: member="Gtk::CheckMenuItem::on_toggled" ref="aaed9d53fc1ee69bb7d65511c24303dac" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual void Gtk::CheckMenuItem::on_toggled </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="a2279f36eb8eb5bef364a150b9b021553"></a><!-- doxytag: member="Gtk::CheckMenuItem::property_active" ref="a2279f36eb8eb5bef364a150b9b021553" 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::CheckMenuItem::property_active </td>
<td>(</td>
<td class="paramname"></td>
<td> ) </td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Whether the menu item is checked. </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="a0abd9bbaee271a248334398d3e53e5b0"></a><!-- doxytag: member="Gtk::CheckMenuItem::property_active" ref="a0abd9bbaee271a248334398d3e53e5b0" 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::CheckMenuItem::property_active </td>
<td>(</td>
<td class="paramname"></td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Whether the menu item is checked. </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="adbd033770269d030c4ee580d24a7fc0f"></a><!-- doxytag: member="Gtk::CheckMenuItem::property_draw_as_radio" ref="adbd033770269d030c4ee580d24a7fc0f" 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::CheckMenuItem::property_draw_as_radio </td>
<td>(</td>
<td class="paramname"></td>
<td> ) </td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Whether the menu item looks like a radio menu item. </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="a9c8cc22364a1adb5cacbf2f16f7ffe14"></a><!-- doxytag: member="Gtk::CheckMenuItem::property_draw_as_radio" ref="a9c8cc22364a1adb5cacbf2f16f7ffe14" 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::CheckMenuItem::property_draw_as_radio </td>
<td>(</td>
<td class="paramname"></td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Whether the menu item looks like a radio menu item. </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="a7aecfd1f61e3b117ba69a34b4cce19ad"></a><!-- doxytag: member="Gtk::CheckMenuItem::property_inconsistent" ref="a7aecfd1f61e3b117ba69a34b4cce19ad" 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::CheckMenuItem::property_inconsistent </td>
<td>(</td>
<td class="paramname"></td>
<td> ) </td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Whether to display an 'inconsistent' state. </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="a1738cb2a515afb19625e143c2c66e7ee"></a><!-- doxytag: member="Gtk::CheckMenuItem::property_inconsistent" ref="a1738cb2a515afb19625e143c2c66e7ee" 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::CheckMenuItem::property_inconsistent </td>
<td>(</td>
<td class="paramname"></td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Whether to display an 'inconsistent' state. </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="ab2b9dca0ea2dbbbf9ebf5c52025d7656"></a><!-- doxytag: member="Gtk::CheckMenuItem::set_active" ref="ab2b9dca0ea2dbbbf9ebf5c52025d7656" args="(bool state=true)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Gtk::CheckMenuItem::set_active </td>
<td>(</td>
<td class="paramtype">bool </td>
<td class="paramname"> <em>state</em> = <code>true</code></td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
</div>
</div>
<a class="anchor" id="a6bc19fef98ea18c634398a654062e4c4"></a><!-- doxytag: member="Gtk::CheckMenuItem::set_draw_as_radio" ref="a6bc19fef98ea18c634398a654062e4c4" args="(bool draw_as_radio=true)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Gtk::CheckMenuItem::set_draw_as_radio </td>
<td>(</td>
<td class="paramtype">bool </td>
<td class="paramname"> <em>draw_as_radio</em> = <code>true</code></td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Sets whether <em>check_menu_item</em> is drawn like a <a class="el" href="classGtk_1_1RadioMenuItem.html" title="A CheckMenuItem that belongs to a group.">Gtk::RadioMenuItem</a>. </p>
<dl class="since_2_4"><dt><b><a class="el" href="since_2_4.html#_since_2_4000059">Since gtkmm 2.4:</a></b></dt><dd></dd></dl>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>draw_as_radio</em> </td><td>Whether <em>check_menu_item</em> is drawn like a <a class="el" href="classGtk_1_1RadioMenuItem.html" title="A CheckMenuItem that belongs to a group.">Gtk::RadioMenuItem</a>. </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a class="anchor" id="a36b7bce27c9be0fc73667486692ac507"></a><!-- doxytag: member="Gtk::CheckMenuItem::set_inconsistent" ref="a36b7bce27c9be0fc73667486692ac507" args="(bool setting=true)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Gtk::CheckMenuItem::set_inconsistent </td>
<td>(</td>
<td class="paramtype">bool </td>
<td class="paramname"> <em>setting</em> = <code>true</code></td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>If the user has selected a range of elements (such as some text or spreadsheet cells) that are affected by a boolean setting, and the current values in that range are inconsistent, you may want to display the check in an "in between" state. </p>
<p>This function turns on "in between" display. Normally you would turn off the inconsistent state again if the user explicitly selects a setting. This has to be done manually, <a class="el" href="classGtk_1_1CheckMenuItem.html#a36b7bce27c9be0fc73667486692ac507" title="If the user has selected a range of elements (such as some text or spreadsheet cells)...">set_inconsistent()</a> only affects visual appearance, it doesn't affect the semantics of the widget. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>setting</em> </td><td><code>true</code> to display an "inconsistent" third state check. </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a class="anchor" id="a91a132cee0317fc3429b78310ddcc46f"></a><!-- doxytag: member="Gtk::CheckMenuItem::signal_toggled" ref="a91a132cee0317fc3429b78310ddcc46f" 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::CheckMenuItem::signal_toggled </td>
<td>(</td>
<td class="paramname"></td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Triggered when the item changes state (Note : changing the item's state with <a class="el" href="classGtk_1_1CheckMenuItem.html#ab2b9dca0ea2dbbbf9ebf5c52025d7656">set_active()</a> will also trigger this signal). </p>
<dl class="user"><dt><b>Prototype:</b></dt><dd><code>void on_my_toggled()</code> </dd></dl>
</div>
</div>
<a class="anchor" id="abfd72929d9158bcf0d59ea73c43c1d28"></a><!-- doxytag: member="Gtk::CheckMenuItem::toggled" ref="abfd72929d9158bcf0d59ea73c43c1d28" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Gtk::CheckMenuItem::toggled </td>
<td>(</td>
<td class="paramname"></td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
</div>
</div>
<hr/><h2>Friends And Related Function Documentation</h2>
<a class="anchor" id="af338c70b431ea56cc0797e015e3d8001"></a><!-- doxytag: member="Gtk::CheckMenuItem::wrap" ref="af338c70b431ea56cc0797e015e3d8001" args="(GtkCheckMenuItem *object, bool take_copy=false)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classGtk_1_1CheckMenuItem.html">Gtk::CheckMenuItem</a>* wrap </td>
<td>(</td>
<td class="paramtype">GtkCheckMenuItem * </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><td> </td>
</tr>
<tr>
<td></td>
<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 border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>object</em> </td><td>The C instance. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>take_copy</em> </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/checkmenuitem.h</li>
</ul>
</div>
<hr size="1"/><address style="text-align: right;"><small>Generated on Tue May 4 13:21:49 2010 for gtkmm by 
<a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.6.1 </small></address>
</body>
</html>
distrib
>
Mandriva
>
2010.1
>
x86_64
>
media
>
main-release
>
by-pkgid
>
22e237efd6851989a23adf3360bb53d0
>
files
>
255
