1999-08-16 18:51:52 +00:00
|
|
|
<!-- ##### SECTION Title ##### -->
|
|
|
|
GtkCheckMenuItem
|
|
|
|
|
|
|
|
<!-- ##### SECTION Short_Description ##### -->
|
2004-10-11 18:08:35 +00:00
|
|
|
A menu item with a check box
|
1999-08-16 18:51:52 +00:00
|
|
|
|
|
|
|
<!-- ##### SECTION Long_Description ##### -->
|
|
|
|
<para>
|
|
|
|
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.
|
|
|
|
</para>
|
|
|
|
|
|
|
|
<para>
|
|
|
|
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.
|
|
|
|
</para>
|
|
|
|
|
|
|
|
<!-- ##### SECTION See_Also ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
2005-06-20 22:06:27 +00:00
|
|
|
<!-- ##### SECTION Stability_Level ##### -->
|
|
|
|
|
|
|
|
|
2010-05-08 05:18:53 +00:00
|
|
|
<!-- ##### SECTION Image ##### -->
|
|
|
|
|
|
|
|
|
1999-08-16 18:51:52 +00:00
|
|
|
<!-- ##### STRUCT GtkCheckMenuItem ##### -->
|
|
|
|
<para>
|
2010-11-30 03:08:09 +00:00
|
|
|
The #GtkCheckMenuItem-struct struct contains only private fields that
|
|
|
|
should not be directly accessed.
|
1999-08-16 18:51:52 +00:00
|
|
|
</para>
|
|
|
|
|
|
|
|
|
2004-07-20 02:26:06 +00:00
|
|
|
<!-- ##### SIGNAL GtkCheckMenuItem::toggled ##### -->
|
|
|
|
<para>
|
|
|
|
This signal is emitted when the state of the check box is changed.
|
|
|
|
</para>
|
|
|
|
|
|
|
|
<para>
|
2010-11-30 03:08:09 +00:00
|
|
|
A signal handler can use gtk_check_menu_item_get_active()
|
|
|
|
to discover the new state.
|
2004-07-20 02:26:06 +00:00
|
|
|
</para>
|
|
|
|
|
|
|
|
@checkmenuitem: the object which received the signal.
|
|
|
|
|
|
|
|
<!-- ##### ARG GtkCheckMenuItem:active ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
<!-- ##### ARG GtkCheckMenuItem:draw-as-radio ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
<!-- ##### ARG GtkCheckMenuItem:inconsistent ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
<!-- ##### ARG GtkCheckMenuItem:indicator-size ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
1999-08-16 18:51:52 +00:00
|
|
|
<!-- ##### FUNCTION gtk_check_menu_item_new ##### -->
|
|
|
|
<para>
|
|
|
|
Creates a new #GtkCheckMenuItem.
|
|
|
|
</para>
|
|
|
|
|
2010-05-08 05:18:53 +00:00
|
|
|
@void:
|
1999-08-16 18:51:52 +00:00
|
|
|
@Returns: a new #GtkCheckMenuItem.
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_check_menu_item_new_with_label ##### -->
|
|
|
|
<para>
|
|
|
|
Creates a new #GtkCheckMenuItem with a label.
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@label: the string to use for the label.
|
|
|
|
@Returns: a new #GtkCheckMenuItem.
|
|
|
|
|
|
|
|
|
2001-10-13 05:52:14 +00:00
|
|
|
<!-- ##### FUNCTION gtk_check_menu_item_new_with_mnemonic ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@label:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_check_menu_item_get_active ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@check_menu_item:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
1999-08-16 18:51:52 +00:00
|
|
|
<!-- ##### FUNCTION gtk_check_menu_item_set_active ##### -->
|
|
|
|
<para>
|
|
|
|
Sets the active state of the menu item's check box.
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@check_menu_item: a #GtkCheckMenuItem.
|
|
|
|
@is_active: boolean value indicating whether the check box is active.
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_check_menu_item_toggled ##### -->
|
|
|
|
<para>
|
|
|
|
Emits the GtkCheckMenuItem::toggled signal.
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@check_menu_item: a #GtkCheckMenuItem.
|
|
|
|
|
|
|
|
|
2001-03-23 22:21:06 +00:00
|
|
|
<!-- ##### FUNCTION gtk_check_menu_item_get_inconsistent ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@check_menu_item:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_check_menu_item_set_inconsistent ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@check_menu_item:
|
|
|
|
@setting:
|
|
|
|
|
|
|
|
|
2003-10-24 22:16:07 +00:00
|
|
|
<!-- ##### FUNCTION gtk_check_menu_item_set_draw_as_radio ##### -->
|
1999-08-16 18:51:52 +00:00
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
2003-10-24 22:16:07 +00:00
|
|
|
@check_menu_item:
|
|
|
|
@draw_as_radio:
|
2001-03-23 23:39:24 +00:00
|
|
|
|
|
|
|
|
2003-10-24 22:16:07 +00:00
|
|
|
<!-- ##### FUNCTION gtk_check_menu_item_get_draw_as_radio ##### -->
|
2003-09-30 17:10:02 +00:00
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
2003-10-24 22:16:07 +00:00
|
|
|
@check_menu_item:
|
|
|
|
@Returns:
|
2001-03-29 21:17:45 +00:00
|
|
|
|
|
|
|
|