<html> <head><title>Gtk-- Reference: Gtk::CheckMenuItem</title></head> <body bgcolor="#F0F0F0" text="#000000" link="#0000FF" vlink="#000077" alink="#FF0000"> <table align=center border=0 cellspacing=10> <tr> <td><a href="class_index.html">Class Index</a></td> <td><a href="cross_index.html">Cross Index</a></td> <td><a href="name_index.html">Namespace Index</a></td> </table> <h1 align=center>Class Gtk::CheckMenuItem</h1><p> <b> A menu item with a check box.</b><br> Contained in: <a href="Gtk.html">Gtk</a><br> Derived from: <a href="Gtk%3A%3AMenuItem.html">Gtk::MenuItem</a> <br> Derived by: <a href="Gtk::RadioMenuItem.html">Gtk::RadioMenuItem</a> <p> #include <gtk--/checkmenuitem.h> <p> <hr noshade> <table border=0> <tr><td colspan=3><h3>public function member index:</h3></td> <tr valign=top><td align=right><tt></tt> </td><td align=right><a href="Gtk%3A%3ACheckMenuItem.html#460"><tt><font color=blue><b>CheckMenuItem</b></font></tt></a></td><td><tt>()</tt>;</td> <tr valign=top><td align=right><tt><tt>explicit</tt> </tt> </td><td align=right><a href="Gtk%3A%3ACheckMenuItem.html#461"><tt><font color=blue><b>CheckMenuItem</b></font></tt></a></td><td><tt>(<tt>const</tt> <tt><font color=navy>string</font></tt>& <tt><font color=blue>label</font></tt>, <tt><font color=purple>gfloat</font></tt> <tt><font color=blue>x</font></tt>=0.0, <tt><font color=purple>gfloat</font></tt> <tt><font color=blue>y</font></tt>=0.5)</tt>;</td> <tr valign=top><td align=right><tt><tt><font color=purple>bool</font></tt></tt> </td><td align=right><a href="Gtk%3A%3ACheckMenuItem.html#465"><tt><font color=blue><b>always_show_toggle</b></font></tt></a></td><td><tt>() <tt>const</tt></tt>;</td> <tr valign=top><td align=right><tt><tt><font color=purple>guint</font></tt></tt> </td><td align=right><a href="Gtk%3A%3ACheckMenuItem.html#462"><tt><font color=blue><b>get_active</b></font></tt></a></td><td><tt>() <tt>const</tt></tt>;</td> <tr valign=top><td align=right><tt><tt><font color=navy>GtkCheckMenuItem</font></tt>*</tt> </td><td align=right><a href="Gtk%3A%3ACheckMenuItem.html#456"><tt><font color=blue><b>gtkobj</b></font></tt></a></td><td><tt>()</tt>;</td> <tr valign=top><td align=right><tt><tt>const</tt> <tt><font color=navy>GtkCheckMenuItem</font></tt>*</tt> </td><td align=right><a href="Gtk%3A%3ACheckMenuItem.html#457"><tt><font color=blue><b>gtkobj</b></font></tt></a></td><td><tt>() <tt>const</tt></tt>;</td> <tr valign=top><td align=right><tt><tt>static</tt> <tt><font color=purple>bool</font></tt></tt> </td><td align=right><a href="Gtk%3A%3ACheckMenuItem.html#458"><tt><font color=blue><b>isA</b></font></tt></a></td><td><tt>(<a href="Gtk%3A%3AObject.html"><tt><font color=navy><b>Object</b></font></tt></a>* <tt><font color=blue>object</font></tt>)</tt>;</td> <tr valign=top><td align=right><tt><tt><font color=purple>bool</font></tt></tt> </td><td align=right><a href="Gtk%3A%3ACheckMenuItem.html#464"><tt><font color=blue><b>is_active</b></font></tt></a></td><td><tt>() <tt>const</tt></tt>;</td> <tr valign=top><td align=right><tt><tt><font color=purple>void</font></tt></tt> </td><td align=right><a href="Gtk%3A%3ACheckMenuItem.html#463"><tt><font color=blue><b>set_active</b></font></tt></a></td><td><tt>(<tt><font color=purple>bool</font></tt> <tt><font color=blue>state</font></tt>=true)</tt>;</td> <tr valign=top><td align=right><tt><tt><font color=purple>void</font></tt></tt> </td><td align=right><a href="Gtk%3A%3ACheckMenuItem.html#466"><tt><font color=blue><b>set_show_toggle</b></font></tt></a></td><td><tt>(<tt><font color=purple>bool</font></tt> <tt><font color=blue>always</font></tt>)</tt>;</td> <tr valign=top><td align=right><tt><tt>emitable</tt> <tt>signal</tt> <tt><font color=purple>void</font></tt></tt> </td><td align=right><a href="Gtk%3A%3ACheckMenuItem.html#467"><tt><font color=blue><b>toggled</b></font></tt></a></td><td><tt>()</tt>;</td> <tr valign=top><td align=right><tt><tt>virtual</tt> </tt> </td><td align=right><a href="Gtk%3A%3ACheckMenuItem.html#459"><tt><font color=blue><b>~CheckMenuItem</b></font></tt></a></td><td><tt>()</tt>;</td> <tr><td> </td><tr><td colspan=3><h3>protected function member index:</h3></td> <tr valign=top><td align=right><tt><tt>virtual</tt> <tt><font color=purple>void</font></tt></tt> </td><td align=right><a href="Gtk%3A%3ACheckMenuItem.html#469"><tt><font color=blue><b>draw_indicator_impl</b></font></tt></a></td><td><tt>(<tt><font color=navy>GdkRectangle</font></tt>* <tt><font color=blue>p0</font></tt>)</tt>;</td> <tr valign=top><td align=right><tt><tt>virtual</tt> <tt><font color=purple>void</font></tt></tt> </td><td align=right><a href="Gtk%3A%3ACheckMenuItem.html#468"><tt><font color=blue><b>toggled_impl</b></font></tt></a></td><td><tt>()</tt>;</td> <tr><td> </td></table> <hr noshade> <h2>Description:</h2> A <tt><font color=navy><b>Gtk::CheckMenuItem</b></font></tt> is a menu item that maintains the state of a boolean value in addition to a <tt><font color=navy><b>Gtk::MenuItem</b></font></tt>'s usual role in activating application code. <P> A check box indicating the state of the boolean value is displayed at the left side of the GtkMenuItem. Activating the GtkMenuItem toggles the value.<br> <p> <hr noshade> <h2>Function Member Descriptions:</h2> <a name="461"><font size=+1><b>Gtk::CheckMenuItem::CheckMenuItem</b></font></a> - Creates a new GtkCheckMenuItem with a label.<br> <hr size="1" width="70%" align="left" noshade="noshade"><tt><tt>explicit</tt> </tt> <a href="Gtk%3A%3ACheckMenuItem.html#461"><tt><font color=blue><b>CheckMenuItem</b></font></tt></a><tt>(<tt>const</tt> <tt><font color=navy>string</font></tt>& <tt><font color=blue>label</font></tt>, <tt><font color=purple>gfloat</font></tt> <tt><font color=blue>x</font></tt>=0.0, <tt><font color=purple>gfloat</font></tt> <tt><font color=blue>y</font></tt>=0.5)</tt>;<br><blockquote> label: The string to use for the label.</blockquote> <br><br> <a name="456"><font size=+1><b>Gtk::CheckMenuItem::gtkobj</b></font></a> - Returns the underlaying gtk+ object.<br> <hr size="1" width="70%" align="left" noshade="noshade"><tt><tt><font color=navy>GtkCheckMenuItem</font></tt>*</tt> <a href="Gtk%3A%3ACheckMenuItem.html#456"><tt><font color=blue><b>gtkobj</b></font></tt></a><tt>()</tt>;<br><br> <a name="458"><font size=+1><b>Gtk::CheckMenuItem::isA</b></font></a> - Returns true if object is this type.<br> <hr size="1" width="70%" align="left" noshade="noshade"><tt><tt>static</tt> <tt><font color=purple>bool</font></tt></tt> <a href="Gtk%3A%3ACheckMenuItem.html#458"><tt><font color=blue><b>isA</b></font></tt></a><tt>(<a href="Gtk%3A%3AObject.html"><tt><font color=navy><b>Object</b></font></tt></a>* <tt><font color=blue>object</font></tt>)</tt>;<br><br> <a name="464"><font size=+1><b>Gtk::CheckMenuItem::is_active</b></font></a> - Get's the active state of the widget.<br> <hr size="1" width="70%" align="left" noshade="noshade"><tt><tt><font color=purple>bool</font></tt></tt> <a href="Gtk%3A%3ACheckMenuItem.html#464"><tt><font color=blue><b>is_active</b></font></tt></a><tt>() <tt>const</tt></tt>;<br><br> <a name="463"><font size=+1><b>Gtk::CheckMenuItem::set_active</b></font></a> - Sets the active state of the menu item's check box.<br> <hr size="1" width="70%" align="left" noshade="noshade"><tt><tt><font color=purple>void</font></tt></tt> <a href="Gtk%3A%3ACheckMenuItem.html#463"><tt><font color=blue><b>set_active</b></font></tt></a><tt>(<tt><font color=purple>bool</font></tt> <tt><font color=blue>state</font></tt>=true)</tt>;<br><blockquote> state: Boolean value indicating whether the check box is active.</blockquote> <br><br> <a name="466"><font size=+1><b>Gtk::CheckMenuItem::set_show_toggle</b></font></a> - Controls whether the check box is shown at all times.<br> <hr size="1" width="70%" align="left" noshade="noshade"><tt><tt><font color=purple>void</font></tt></tt> <a href="Gtk%3A%3ACheckMenuItem.html#466"><tt><font color=blue><b>set_show_toggle</b></font></tt></a><tt>(<tt><font color=purple>bool</font></tt> <tt><font color=blue>always</font></tt>)</tt>;<br><blockquote> Normally the check box is shown only when it is active or while the menu item is selected. <P> always: Boolean value indicating whether to always show the check box.</blockquote> <br><br> <hr noshade> </html>