<?xml version="1.0"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
               "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
<!ENTITY % local.common.attrib "xmlns:xi  CDATA  #FIXED 'http://www.w3.org/2003/XInclude'">
<!ENTITY version SYSTEM "version.xml">
]>
<!--ENTITY index-Objects-Grouped SYSTEM "objects_grouped.sgml"-->
<refentry id="GtkCheckMenuItem">
<refmeta>
<refentrytitle role="top_of_page" id="GtkCheckMenuItem.top_of_page">GtkCheckMenuItem</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo>GTK Library</refmiscinfo>
</refmeta>

<refnamediv>
<refname>GtkCheckMenuItem</refname>
<refpurpose>A menu item with a check box</refpurpose>
</refnamediv>

<refsynopsisdiv id="GtkCheckMenuItem.synopsis" role="synopsis">
<title role="synopsis.title">Synopsis</title>

<synopsis>

#include &lt;gtk/gtk.h&gt;

                    <link linkend="GtkCheckMenuItem-struct">GtkCheckMenuItem</link>;
<link linkend="GtkWidget">GtkWidget</link>*          <link linkend="gtk-check-menu-item-new">gtk_check_menu_item_new</link>             (void);
<link linkend="GtkWidget">GtkWidget</link>*          <link linkend="gtk-check-menu-item-new-with-label">gtk_check_menu_item_new_with_label</link>  (const <link linkend="gchar">gchar</link> *label);
<link linkend="GtkWidget">GtkWidget</link>*          <link linkend="gtk-check-menu-item-new-with-mnemonic">gtk_check_menu_item_new_with_mnemonic</link>
                                                        (const <link linkend="gchar">gchar</link> *label);
#define             <link linkend="gtk-check-menu-item-set-state">gtk_check_menu_item_set_state</link>
<link linkend="gboolean">gboolean</link>            <link linkend="gtk-check-menu-item-get-active">gtk_check_menu_item_get_active</link>      (<link linkend="GtkCheckMenuItem">GtkCheckMenuItem</link> *check_menu_item);
<link linkend="void">void</link>                <link linkend="gtk-check-menu-item-set-active">gtk_check_menu_item_set_active</link>      (<link linkend="GtkCheckMenuItem">GtkCheckMenuItem</link> *check_menu_item,
                                                         <link linkend="gboolean">gboolean</link> is_active);
<link linkend="void">void</link>                <link linkend="gtk-check-menu-item-set-show-toggle">gtk_check_menu_item_set_show_toggle</link> (<link linkend="GtkCheckMenuItem">GtkCheckMenuItem</link> *menu_item,
                                                         <link linkend="gboolean">gboolean</link> always);
<link linkend="void">void</link>                <link linkend="gtk-check-menu-item-toggled">gtk_check_menu_item_toggled</link>         (<link linkend="GtkCheckMenuItem">GtkCheckMenuItem</link> *check_menu_item);
<link linkend="gboolean">gboolean</link>            <link linkend="gtk-check-menu-item-get-inconsistent">gtk_check_menu_item_get_inconsistent</link>
                                                        (<link linkend="GtkCheckMenuItem">GtkCheckMenuItem</link> *check_menu_item);
<link linkend="void">void</link>                <link linkend="gtk-check-menu-item-set-inconsistent">gtk_check_menu_item_set_inconsistent</link>
                                                        (<link linkend="GtkCheckMenuItem">GtkCheckMenuItem</link> *check_menu_item,
                                                         <link linkend="gboolean">gboolean</link> setting);
<link linkend="void">void</link>                <link linkend="gtk-check-menu-item-set-draw-as-radio">gtk_check_menu_item_set_draw_as_radio</link>
                                                        (<link linkend="GtkCheckMenuItem">GtkCheckMenuItem</link> *check_menu_item,
                                                         <link linkend="gboolean">gboolean</link> draw_as_radio);
<link linkend="gboolean">gboolean</link>            <link linkend="gtk-check-menu-item-get-draw-as-radio">gtk_check_menu_item_get_draw_as_radio</link>
                                                        (<link linkend="GtkCheckMenuItem">GtkCheckMenuItem</link> *check_menu_item);
</synopsis>
</refsynopsisdiv>

<refsect1 id="GtkCheckMenuItem.object-hierarchy" role="object_hierarchy">
<title role="object_hierarchy.title">Object Hierarchy</title>
<synopsis>
  <link linkend="GObject">GObject</link>
   +----<link linkend="GInitiallyUnowned">GInitiallyUnowned</link>
         +----<link linkend="GtkObject">GtkObject</link>
               +----<link linkend="GtkWidget">GtkWidget</link>
                     +----<link linkend="GtkContainer">GtkContainer</link>
                           +----<link linkend="GtkBin">GtkBin</link>
                                 +----<link linkend="GtkItem">GtkItem</link>
                                       +----<link linkend="GtkMenuItem">GtkMenuItem</link>
                                             +----GtkCheckMenuItem
                                                   +----<link linkend="GtkRadioMenuItem">GtkRadioMenuItem</link>
</synopsis>
</refsect1>



<refsect1 id="GtkCheckMenuItem.implemented-interfaces" role="impl_interfaces">
<title role="impl_interfaces.title">Implemented Interfaces</title>
<para>
GtkCheckMenuItem implements
 <link linkend="GtkActivatable">GtkActivatable</link>,  <link linkend="AtkImplementorIface">AtkImplementorIface</link> and  <link linkend="GtkBuildable">GtkBuildable</link>.</para>
</refsect1>


<refsect1 id="GtkCheckMenuItem.properties" role="properties">
<title role="properties.title">Properties</title>
<synopsis>
  &quot;<link linkend="GtkCheckMenuItem--active">active</link>&quot;                   <link linkend="gboolean">gboolean</link>              : Read / Write
  &quot;<link linkend="GtkCheckMenuItem--draw-as-radio">draw-as-radio</link>&quot;            <link linkend="gboolean">gboolean</link>              : Read / Write
  &quot;<link linkend="GtkCheckMenuItem--inconsistent">inconsistent</link>&quot;             <link linkend="gboolean">gboolean</link>              : Read / Write
</synopsis>
</refsect1>
<refsect1 id="GtkCheckMenuItem.style-properties" role="style_properties">
<title role="style_properties.title">Style Properties</title>
<synopsis>
  &quot;<link linkend="GtkCheckMenuItem--s-indicator-size">indicator-size</link>&quot;           <link linkend="gint">gint</link>                  : Read
</synopsis>
</refsect1>

<refsect1 id="GtkCheckMenuItem.signals" role="signal_proto">
<title role="signal_proto.title">Signals</title>
<synopsis>
  &quot;<link linkend="GtkCheckMenuItem-toggled">toggled</link>&quot;                                        : Run First
</synopsis>
</refsect1>


<refsect1 id="GtkCheckMenuItem.description" role="desc">
<title role="desc.title">Description</title>
<para>
A <link linkend="GtkCheckMenuItem"><type>GtkCheckMenuItem</type></link> is a menu item that maintains the state of a boolean
value in addition to a <link linkend="GtkMenuItem"><type>GtkMenuItem</type></link>'s usual role in activating application
code.
</para>
<para>
A check box indicating the state of the boolean value is displayed
at the left side of the <link linkend="GtkMenuItem"><type>GtkMenuItem</type></link>.  Activating the <link linkend="GtkMenuItem"><type>GtkMenuItem</type></link>
toggles the value.
</para>
</refsect1>

<refsect1 id="GtkCheckMenuItem.details" role="details">
<title role="details.title">Details</title>
<refsect2 id="GtkCheckMenuItem-struct" role="struct">
<title>GtkCheckMenuItem</title>
<indexterm zone="GtkCheckMenuItem-struct"><primary sortas="CheckMenuItem">GtkCheckMenuItem</primary></indexterm><programlisting>typedef struct _GtkCheckMenuItem GtkCheckMenuItem;</programlisting>
<para>
The <link linkend="GtkCheckMenuItem-struct"><type>GtkCheckMenuItem</type></link> struct contains the following fields.
(These fields should be considered read-only. They should never be set by
an application.)
<informaltable pgwide="1" frame="none" role="struct">
<tgroup cols="2"><colspec colwidth="2*"/><colspec colwidth="8*"/>
<tbody>
<row>
<entry><link linkend="guint"><type>guint</type></link> active;</entry>
<entry>TRUE if the check box is active.</entry>
</row>
</tbody></tgroup></informaltable>
</para></refsect2>
<refsect2 id="gtk-check-menu-item-new" role="function">
<title>gtk_check_menu_item_new ()</title>
<indexterm zone="gtk-check-menu-item-new"><primary sortas="check_menu_item_new">gtk_check_menu_item_new</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link>*          gtk_check_menu_item_new             (void);</programlisting>
<para>
Creates a new <link linkend="GtkCheckMenuItem"><type>GtkCheckMenuItem</type></link>.
</para><variablelist role="params">
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>a new <link linkend="GtkCheckMenuItem"><type>GtkCheckMenuItem</type></link>.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-check-menu-item-new-with-label" role="function">
<title>gtk_check_menu_item_new_with_label ()</title>
<indexterm zone="gtk-check-menu-item-new-with-label"><primary sortas="check_menu_item_new_with_label">gtk_check_menu_item_new_with_label</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link>*          gtk_check_menu_item_new_with_label  (const <link linkend="gchar">gchar</link> *label);</programlisting>
<para>
Creates a new <link linkend="GtkCheckMenuItem"><type>GtkCheckMenuItem</type></link> with a label.
</para><variablelist role="params">
<varlistentry><term><parameter>label</parameter>&#160;:</term>
<listitem><simpara>the string to use for the label.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>a new <link linkend="GtkCheckMenuItem"><type>GtkCheckMenuItem</type></link>.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-check-menu-item-new-with-mnemonic" role="function">
<title>gtk_check_menu_item_new_with_mnemonic ()</title>
<indexterm zone="gtk-check-menu-item-new-with-mnemonic"><primary sortas="check_menu_item_new_with_mnemonic">gtk_check_menu_item_new_with_mnemonic</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link>*          gtk_check_menu_item_new_with_mnemonic
                                                        (const <link linkend="gchar">gchar</link> *label);</programlisting>
<para>
Creates a new <link linkend="GtkCheckMenuItem"><type>GtkCheckMenuItem</type></link> containing a label. The label
will be created using <link linkend="gtk-label-new-with-mnemonic"><function>gtk_label_new_with_mnemonic()</function></link>, so underscores
in <parameter>label</parameter> indicate the mnemonic for the menu item.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>label</parameter>&#160;:</term>
<listitem><simpara> The text of the button, with an underscore in front of the
        mnemonic character
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a new <link linkend="GtkCheckMenuItem"><type>GtkCheckMenuItem</type></link>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-check-menu-item-set-state" role="macro" condition="deprecated:Use gtk_check_menu_item_set_active() instead.">
<title>gtk_check_menu_item_set_state</title>
<indexterm zone="gtk-check-menu-item-set-state" role="deprecated"><primary sortas="check_menu_item_set_state">gtk_check_menu_item_set_state</primary></indexterm><programlisting>#define	gtk_check_menu_item_set_state		gtk_check_menu_item_set_active
</programlisting>
<warning><para><literal>gtk_check_menu_item_set_state</literal> is deprecated and should not be used in newly-written code. Use <link linkend="gtk-check-menu-item-set-active"><function>gtk_check_menu_item_set_active()</function></link> instead.</para></warning>
<para>
Sets the active state of the menu item's check box.
</para></refsect2>
<refsect2 id="gtk-check-menu-item-get-active" role="function">
<title>gtk_check_menu_item_get_active ()</title>
<indexterm zone="gtk-check-menu-item-get-active"><primary sortas="check_menu_item_get_active">gtk_check_menu_item_get_active</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            gtk_check_menu_item_get_active      (<link linkend="GtkCheckMenuItem">GtkCheckMenuItem</link> *check_menu_item);</programlisting>
<para>
Returns whether the check menu item is active. See
<link linkend="gtk-check-menu-item-set-active"><function>gtk_check_menu_item_set_active()</function></link>.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>check_menu_item</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkCheckMenuItem"><type>GtkCheckMenuItem</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> <link linkend="TRUE--CAPS"><literal>TRUE</literal></link> if the menu item is checked.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-check-menu-item-set-active" role="function">
<title>gtk_check_menu_item_set_active ()</title>
<indexterm zone="gtk-check-menu-item-set-active"><primary sortas="check_menu_item_set_active">gtk_check_menu_item_set_active</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_check_menu_item_set_active      (<link linkend="GtkCheckMenuItem">GtkCheckMenuItem</link> *check_menu_item,
                                                         <link linkend="gboolean">gboolean</link> is_active);</programlisting>
<para>
Sets the active state of the menu item's check box.
</para><variablelist role="params">
<varlistentry><term><parameter>check_menu_item</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GtkCheckMenuItem"><type>GtkCheckMenuItem</type></link>.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>is_active</parameter>&#160;:</term>
<listitem><simpara>boolean value indicating whether the check box is active.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-check-menu-item-set-show-toggle" role="function" condition="deprecated:">
<title>gtk_check_menu_item_set_show_toggle ()</title>
<indexterm zone="gtk-check-menu-item-set-show-toggle" role="deprecated"><primary sortas="check_menu_item_set_show_toggle">gtk_check_menu_item_set_show_toggle</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_check_menu_item_set_show_toggle (<link linkend="GtkCheckMenuItem">GtkCheckMenuItem</link> *menu_item,
                                                         <link linkend="gboolean">gboolean</link> always);</programlisting>
<warning><para><literal>gtk_check_menu_item_set_show_toggle</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
Controls whether the check box is shown at all times.
Normally the check box is shown only when it is active or while the
menu item is selected.
</para><variablelist role="params">
<varlistentry><term><parameter>menu_item</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GtkCheckMenuItem"><type>GtkCheckMenuItem</type></link>.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>always</parameter>&#160;:</term>
<listitem><simpara>boolean value indicating whether to always show the check box.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-check-menu-item-toggled" role="function">
<title>gtk_check_menu_item_toggled ()</title>
<indexterm zone="gtk-check-menu-item-toggled"><primary sortas="check_menu_item_toggled">gtk_check_menu_item_toggled</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_check_menu_item_toggled         (<link linkend="GtkCheckMenuItem">GtkCheckMenuItem</link> *check_menu_item);</programlisting>
<para>
Emits the GtkCheckMenuItem::toggled signal.
</para><variablelist role="params">
<varlistentry><term><parameter>check_menu_item</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GtkCheckMenuItem"><type>GtkCheckMenuItem</type></link>.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-check-menu-item-get-inconsistent" role="function">
<title>gtk_check_menu_item_get_inconsistent ()</title>
<indexterm zone="gtk-check-menu-item-get-inconsistent"><primary sortas="check_menu_item_get_inconsistent">gtk_check_menu_item_get_inconsistent</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            gtk_check_menu_item_get_inconsistent
                                                        (<link linkend="GtkCheckMenuItem">GtkCheckMenuItem</link> *check_menu_item);</programlisting>
<para>
Retrieves the value set by <link linkend="gtk-check-menu-item-set-inconsistent"><function>gtk_check_menu_item_set_inconsistent()</function></link>.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>check_menu_item</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkCheckMenuItem"><type>GtkCheckMenuItem</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> <link linkend="TRUE--CAPS"><literal>TRUE</literal></link> if inconsistent
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-check-menu-item-set-inconsistent" role="function">
<title>gtk_check_menu_item_set_inconsistent ()</title>
<indexterm zone="gtk-check-menu-item-set-inconsistent"><primary sortas="check_menu_item_set_inconsistent">gtk_check_menu_item_set_inconsistent</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_check_menu_item_set_inconsistent
                                                        (<link linkend="GtkCheckMenuItem">GtkCheckMenuItem</link> *check_menu_item,
                                                         <link linkend="gboolean">gboolean</link> setting);</programlisting>
<para>
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. 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, <link linkend="gtk-check-menu-item-set-inconsistent"><function>gtk_check_menu_item_set_inconsistent()</function></link> only affects
visual appearance, it doesn't affect the semantics of the widget.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>check_menu_item</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkCheckMenuItem"><type>GtkCheckMenuItem</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>setting</parameter>&#160;:</term>
<listitem><simpara> <link linkend="TRUE--CAPS"><literal>TRUE</literal></link> to display an "inconsistent" third state check
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-check-menu-item-set-draw-as-radio" role="function" condition="since:2.4">
<title>gtk_check_menu_item_set_draw_as_radio ()</title>
<indexterm zone="gtk-check-menu-item-set-draw-as-radio" role="2.4"><primary sortas="check_menu_item_set_draw_as_radio">gtk_check_menu_item_set_draw_as_radio</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_check_menu_item_set_draw_as_radio
                                                        (<link linkend="GtkCheckMenuItem">GtkCheckMenuItem</link> *check_menu_item,
                                                         <link linkend="gboolean">gboolean</link> draw_as_radio);</programlisting>
<para>
Sets whether <parameter>check_menu_item</parameter> is drawn like a <link linkend="GtkRadioMenuItem"><type>GtkRadioMenuItem</type></link></para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>check_menu_item</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkCheckMenuItem"><type>GtkCheckMenuItem</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>draw_as_radio</parameter>&#160;:</term>
<listitem><simpara> whether <parameter>check_menu_item</parameter> is drawn like a <link linkend="GtkRadioMenuItem"><type>GtkRadioMenuItem</type></link>
</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.4</para></refsect2>
<refsect2 id="gtk-check-menu-item-get-draw-as-radio" role="function" condition="since:2.4">
<title>gtk_check_menu_item_get_draw_as_radio ()</title>
<indexterm zone="gtk-check-menu-item-get-draw-as-radio" role="2.4"><primary sortas="check_menu_item_get_draw_as_radio">gtk_check_menu_item_get_draw_as_radio</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            gtk_check_menu_item_get_draw_as_radio
                                                        (<link linkend="GtkCheckMenuItem">GtkCheckMenuItem</link> *check_menu_item);</programlisting>
<para>
Returns whether <parameter>check_menu_item</parameter> looks like a <link linkend="GtkRadioMenuItem"><type>GtkRadioMenuItem</type></link></para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>check_menu_item</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkCheckMenuItem"><type>GtkCheckMenuItem</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> Whether <parameter>check_menu_item</parameter> looks like a <link linkend="GtkRadioMenuItem"><type>GtkRadioMenuItem</type></link>

</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.4</para></refsect2>

</refsect1>
<refsect1 id="GtkCheckMenuItem.property-details" role="property_details">
<title role="property_details.title">Property Details</title>
<refsect2 id="GtkCheckMenuItem--active" role="property"><title>The <literal>&quot;active&quot;</literal> property</title>
<indexterm zone="GtkCheckMenuItem--active"><primary sortas="CheckMenuItem:active">GtkCheckMenuItem:active</primary></indexterm><programlisting>  &quot;active&quot;                   <link linkend="gboolean">gboolean</link>              : Read / Write</programlisting>
<para>Whether the menu item is checked.</para><para>Default value: FALSE</para>
</refsect2>
<refsect2 id="GtkCheckMenuItem--draw-as-radio" role="property"><title>The <literal>&quot;draw-as-radio&quot;</literal> property</title>
<indexterm zone="GtkCheckMenuItem--draw-as-radio"><primary sortas="CheckMenuItem:draw-as-radio">GtkCheckMenuItem:draw-as-radio</primary></indexterm><programlisting>  &quot;draw-as-radio&quot;            <link linkend="gboolean">gboolean</link>              : Read / Write</programlisting>
<para>Whether the menu item looks like a radio menu item.</para><para>Default value: FALSE</para>
</refsect2>
<refsect2 id="GtkCheckMenuItem--inconsistent" role="property"><title>The <literal>&quot;inconsistent&quot;</literal> property</title>
<indexterm zone="GtkCheckMenuItem--inconsistent"><primary sortas="CheckMenuItem:inconsistent">GtkCheckMenuItem:inconsistent</primary></indexterm><programlisting>  &quot;inconsistent&quot;             <link linkend="gboolean">gboolean</link>              : Read / Write</programlisting>
<para>Whether to display an "inconsistent" state.</para><para>Default value: FALSE</para>
</refsect2>
</refsect1>
<refsect1 id="GtkCheckMenuItem.style-property-details" role="style_properties_details">
<title role="style_properties_details.title">Style Property Details</title>
<refsect2 id="GtkCheckMenuItem--s-indicator-size" role="property"><title>The <literal>&quot;indicator-size&quot;</literal> style property</title>
<indexterm zone="GtkCheckMenuItem--s-indicator-size"><primary sortas="CheckMenuItem:indicator-size">GtkCheckMenuItem:indicator-size</primary></indexterm><programlisting>  &quot;indicator-size&quot;           <link linkend="gint">gint</link>                  : Read</programlisting>
<para>Size of check or radio indicator.</para><para>Allowed values: &gt;= 0</para>
<para>Default value: 13</para>
</refsect2>
</refsect1>

<refsect1 id="GtkCheckMenuItem.signal-details" role="signals">
<title role="signals.title">Signal Details</title>
<refsect2 id="GtkCheckMenuItem-toggled" role="signal"><title>The <literal>&quot;toggled&quot;</literal> signal</title>
<indexterm zone="GtkCheckMenuItem-toggled"><primary sortas="CheckMenuItem::toggled">GtkCheckMenuItem::toggled</primary></indexterm><programlisting><link linkend="void">void</link>                user_function                      (<link linkend="GtkCheckMenuItem">GtkCheckMenuItem</link> *checkmenuitem,
                                                        <link linkend="gpointer">gpointer</link>          user_data)          : Run First</programlisting>
<para>
This signal is emitted when the state of the check box is changed.
</para>
<para>
A signal handler can examine the <structfield>active</structfield>
field of the <link linkend="GtkCheckMenuItem-struct"><type>GtkCheckMenuItem</type></link> struct to discover the new state.
</para><variablelist role="params">
<varlistentry><term><parameter>checkmenuitem</parameter>&#160;:</term>
<listitem><simpara>the object which received the signal.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&#160;:</term>
<listitem><simpara>user data set when the signal handler was connected.</simpara></listitem></varlistentry>
</variablelist></refsect2>
</refsect1>



</refentry>
