GtkCheckMenuItem a menu item with a check box. A #GtkCheckMenuItem is a menu item that maintains the state of a boolean value in addition to a #GtkMenuItem's usual role in activating application code. 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. The #GtkCheckMenuItem-struct struct contains the following fields. (These fields should be considered read-only. They should never be set by an application.) #guint active; TRUE if the check box is active. Creates a new #GtkCheckMenuItem. @Returns: a new #GtkCheckMenuItem. Creates a new #GtkCheckMenuItem with a label. @label: the string to use for the label. @Returns: a new #GtkCheckMenuItem. This macro is provided to preserve compatibility with older code. New code should use gtk_check_menu_item_set_active() function instead. Sets the active state of the menu item's check box. @check_menu_item: a #GtkCheckMenuItem. @is_active: boolean value indicating whether the check box is active. 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. @menu_item: a #GtkCheckMenuItem. @always: boolean value indicating whether to always show the check box. Emits the GtkCheckMenuItem::toggled signal. @check_menu_item: a #GtkCheckMenuItem. @check_menu_item: @Returns: @check_menu_item: @setting: This signal is emitted when the state of the check box is changed. A signal handler can examine the active field of the #GtkCheckMenuItem-struct struct to discover the new state. @checkmenuitem: the object which received the signal.