📄 gtkcheckmenuitem.html
字号:
<HTML><HEAD><TITLE>GtkCheckMenuItem</TITLE><METANAME="GENERATOR"CONTENT="Modular DocBook HTML Stylesheet Version 1.61"><LINKREL="HOME"TITLE="GTK+ Reference Manual"HREF="index.html"><LINKREL="UP"TITLE="GTK+ Widgets and Objects"HREF="gtkobjects.html"><LINKREL="PREVIOUS"TITLE="GtkCheckButton"HREF="gtkcheckbutton.html"><LINKREL="NEXT"TITLE="GtkCList"HREF="gtkclist.html"></HEAD><BODYCLASS="REFENTRY"BGCOLOR="#FFFFFF"TEXT="#000000"LINK="#0000FF"VLINK="#840084"ALINK="#0000FF"><DIVCLASS="NAVHEADER"><TABLEWIDTH="100%"BORDER="0"BGCOLOR="#000000"CELLPADDING="1"CELLSPACING="0"><TR><THCOLSPAN="4"ALIGN="center"><FONTCOLOR="#FFFFFF"SIZE="5">GTK+ Reference Manual</FONT></TH></TR><TR><TDWIDTH="25%"BGCOLOR="#C00000"ALIGN="left"><AHREF="gtkcheckbutton.html"><FONTCOLOR="#FFFFFF"SIZE="3"><B><<< Previous Page</B></FONT></A></TD><TDWIDTH="25%"BGCOLOR="#0000C0"ALIGN="center"><FONTCOLOR="#FFFFFF"SIZE="3"><B><AHREF="index.html"><FONTCOLOR="#FFFFFF"SIZE="3"><B>Home</B></FONT></A></B></FONT></TD><TDWIDTH="25%"BGCOLOR="#00C000"ALIGN="center"><FONTCOLOR="#FFFFFF"SIZE="3"><B><AHREF="gtkobjects.html"><FONTCOLOR="#FFFFFF"SIZE="3"><B>Up</B></FONT></A></B></FONT></TD><TDWIDTH="25%"BGCOLOR="#C00000"ALIGN="right"><AHREF="gtkclist.html"><FONTCOLOR="#FFFFFF"SIZE="3"><B>Next Page >>></B></FONT></A></TD></TR></TABLE></DIV><H1><ANAME="GTKCHECKMENUITEM">GtkCheckMenuItem</A></H1><DIVCLASS="REFNAMEDIV"><ANAME="AEN15713"></A><H2>Name</H2>GtkCheckMenuItem -- a menu item with a check box.</DIV><DIVCLASS="REFSYNOPSISDIV"><ANAME="AEN15716"></A><H2>Synopsis</H2><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="SYNOPSIS"> #include <gtk/gtk.h>struct <AHREF="gtkcheckmenuitem.html#GTKCHECKMENUITEM-STRUCT">GtkCheckMenuItem</A>;<AHREF="gtkwidget.html">GtkWidget</A>* <AHREF="gtkcheckmenuitem.html#GTK-CHECK-MENU-ITEM-NEW">gtk_check_menu_item_new</A> (void);<AHREF="gtkwidget.html">GtkWidget</A>* <AHREF="gtkcheckmenuitem.html#GTK-CHECK-MENU-ITEM-NEW-WITH-LABEL">gtk_check_menu_item_new_with_label</A> (const <AHREF=../glib/glib-basic-types.html#GCHAR>gchar</A> *label);#define <AHREF="gtkcheckmenuitem.html#GTK-CHECK-MENU-ITEM-SET-STATE">gtk_check_menu_item_set_state</A>void <AHREF="gtkcheckmenuitem.html#GTK-CHECK-MENU-ITEM-SET-ACTIVE">gtk_check_menu_item_set_active</A> (<AHREF="gtkcheckmenuitem.html">GtkCheckMenuItem</A> *check_menu_item, <AHREF=../glib/glib-basic-types.html#GBOOLEAN>gboolean</A> is_active);void <AHREF="gtkcheckmenuitem.html#GTK-CHECK-MENU-ITEM-SET-SHOW-TOGGLE">gtk_check_menu_item_set_show_toggle</A> (<AHREF="gtkcheckmenuitem.html">GtkCheckMenuItem</A> *menu_item, <AHREF=../glib/glib-basic-types.html#GBOOLEAN>gboolean</A> always);void <AHREF="gtkcheckmenuitem.html#GTK-CHECK-MENU-ITEM-TOGGLED">gtk_check_menu_item_toggled</A> (<AHREF="gtkcheckmenuitem.html">GtkCheckMenuItem</A> *check_menu_item); </PRE></TD></TR></TABLE></DIV><DIVCLASS="REFSECT1"><ANAME="AEN15734"></A><H2>Object Hierarchy</H2><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="SYNOPSIS"> <AHREF="gtkobject.html">GtkObject</A> +----<AHREF="gtkwidget.html">GtkWidget</A> +----<AHREF="gtkcontainer.html">GtkContainer</A> +----<AHREF="gtkbin.html">GtkBin</A> +----<AHREF="gtkitem.html">GtkItem</A> +----<AHREF="gtkmenuitem.html">GtkMenuItem</A> +----GtkCheckMenuItem</PRE></TD></TR></TABLE></DIV><DIVCLASS="REFSECT1"><ANAME="AEN15743"></A><H2>Signal Prototypes</H2><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="SYNOPSIS"> "<AHREF="gtkcheckmenuitem.html#GTKCHECKMENUITEM-TOGGLED">toggled</A>" void user_function (<AHREF="gtkcheckmenuitem.html">GtkCheckMenuItem</A> *checkmenuitem, <AHREF=../glib/glib-basic-types.html#GPOINTER>gpointer</A> user_data);</PRE></TD></TR></TABLE></DIV><DIVCLASS="REFSECT1"><ANAME="AEN15749"></A><H2>Description</H2><P>A <AHREF="gtkcheckmenuitem.html">GtkCheckMenuItem</A> is a menu item that maintains the state of a boolean value in addition to a <AHREF="gtkmenuitem.html">GtkMenuItem</A>'s usual role in activating applicationcode.</P><P>A check box indicating the state of the boolean value is displayedat the left side of the <AHREF="gtkmenuitem.html">GtkMenuItem</A>. Activating the <AHREF="gtkmenuitem.html">GtkMenuItem</A> toggles the value.</P></DIV><DIVCLASS="REFSECT1"><ANAME="AEN15757"></A><H2>Details</H2><DIVCLASS="REFSECT2"><ANAME="AEN15759"></A><H3><ANAME="GTKCHECKMENUITEM-STRUCT"></A>struct GtkCheckMenuItem</H3><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="PROGRAMLISTING">struct GtkCheckMenuItem;</PRE></TD></TR></TABLE><P>The <AHREF="gtkcheckmenuitem.html#GTKCHECKMENUITEM-STRUCT">GtkCheckMenuItem</A> struct contains the following fields.(These fields should be considered read-only. They should never be set byan application.)<DIVCLASS="INFORMALTABLE"><ANAME="AEN15765"></A><P></P><TABLEBORDER="0"WIDTH="100%"BGCOLOR="#FFF0D0"CELLSPACING="0"CELLPADDING="4"CLASS="CALSTABLE"><TBODY><TR><TDWIDTH="20%"ALIGN="LEFT"VALIGN="TOP"><AHREF=../glib/glib-basic-types.html#GUINT>guint</A> active;</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">TRUE if the check box is active.</TD></TR></TBODY></TABLE><P></P></DIV></P></DIV><HR><DIVCLASS="REFSECT2"><ANAME="AEN15774"></A><H3><ANAME="GTK-CHECK-MENU-ITEM-NEW"></A>gtk_check_menu_item_new ()</H3><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="PROGRAMLISTING"><AHREF="gtkwidget.html">GtkWidget</A>* gtk_check_menu_item_new (void);</PRE></TD></TR></TABLE><P>Creates a new <AHREF="gtkcheckmenuitem.html">GtkCheckMenuItem</A>.</P><DIVCLASS="INFORMALTABLE"><ANAME="AEN15781"></A><P></P><TABLEBORDER="0"WIDTH="100%"BGCOLOR="#FFD0D0"CELLSPACING="0"CELLPADDING="4"CLASS="CALSTABLE"><TBODY><TR><TDWIDTH="20%"ALIGN="RIGHT"VALIGN="TOP"><ICLASS="EMPHASIS">Returns</I> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">a new <AHREF="gtkcheckmenuitem.html">GtkCheckMenuItem</A>. </TD></TR></TBODY></TABLE><P></P></DIV></DIV><HR><DIVCLASS="REFSECT2"><ANAME="AEN15791"></A><H3><ANAME="GTK-CHECK-MENU-ITEM-NEW-WITH-LABEL"></A>gtk_check_menu_item_new_with_label ()</H3><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="PROGRAMLISTING"><AHREF="gtkwidget.html">GtkWidget</A>* gtk_check_menu_item_new_with_label (const <AHREF=../glib/glib-basic-types.html#GCHAR>gchar</A> *label);</PRE></TD></TR></TABLE><P>Creates a new <AHREF="gtkcheckmenuitem.html">GtkCheckMenuItem</A> with a label.</P><DIVCLASS="INFORMALTABLE"><ANAME="AEN15799"></A><P></P><TABLEBORDER="0"WIDTH="100%"BGCOLOR="#FFD0D0"CELLSPACING="0"CELLPADDING="4"CLASS="CALSTABLE"><TBODY><TR><TDWIDTH="20%"ALIGN="RIGHT"VALIGN="TOP"><TTCLASS="PARAMETER"><I>label</I></TT> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">the string to use for the label.</TD></TR><TR><TDWIDTH="20%"ALIGN="RIGHT"VALIGN="TOP"><ICLASS="EMPHASIS">Returns</I> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">a new <AHREF="gtkcheckmenuitem.html">GtkCheckMenuItem</A>. </TD></TR></TBODY></TABLE><P></P></DIV></DIV><HR><DIVCLASS="REFSECT2"><ANAME="AEN15813"></A><H3><ANAME="GTK-CHECK-MENU-ITEM-SET-STATE"></A>gtk_check_menu_item_set_state</H3><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="PROGRAMLISTING">#define gtk_check_menu_item_set_state gtk_check_menu_item_set_active</PRE></TD></TR></TABLE><P>This macro is provided to preserve compatibility with older code.New code should use <AHREF="gtkcheckmenuitem.html#GTK-CHECK-MENU-ITEM-SET-ACTIVE">gtk_check_menu_item_set_active</A>() function instead.</P></DIV><HR><DIVCLASS="REFSECT2"><ANAME="AEN15819"></A><H3><ANAME="GTK-CHECK-MENU-ITEM-SET-ACTIVE"></A>gtk_check_menu_item_set_active ()</H3><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="PROGRAMLISTING">void gtk_check_menu_item_set_active (<AHREF="gtkcheckmenuitem.html">GtkCheckMenuItem</A> *check_menu_item, <AHREF=../glib/glib-basic-types.html#GBOOLEAN>gboolean</A> is_active);</PRE></TD></TR></TABLE><P>Sets the active state of the menu item's check box.</P><DIVCLASS="INFORMALTABLE"><ANAME="AEN15826"></A><P></P><TABLEBORDER="0"WIDTH="100%"BGCOLOR="#FFD0D0"CELLSPACING="0"CELLPADDING="4"CLASS="CALSTABLE"><TBODY><TR><TDWIDTH="20%"ALIGN="RIGHT"VALIGN="TOP"><TTCLASS="PARAMETER"><I>check_menu_item</I></TT> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">a <AHREF="gtkcheckmenuitem.html">GtkCheckMenuItem</A>.</TD></TR><TR><TDWIDTH="20%"ALIGN="RIGHT"VALIGN="TOP"><TTCLASS="PARAMETER"><I>is_active</I></TT> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">boolean value indicating whether the check box is active. </TD></TR></TBODY></TABLE><P></P></DIV></DIV><HR><DIVCLASS="REFSECT2"><ANAME="AEN15840"></A><H3><ANAME="GTK-CHECK-MENU-ITEM-SET-SHOW-TOGGLE"></A>gtk_check_menu_item_set_show_toggle ()</H3><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="PROGRAMLISTING">void gtk_check_menu_item_set_show_toggle (<AHREF="gtkcheckmenuitem.html">GtkCheckMenuItem</A> *menu_item, <AHREF=../glib/glib-basic-types.html#GBOOLEAN>gboolean</A> always);</PRE></TD></TR></TABLE><P>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.</P><DIVCLASS="INFORMALTABLE"><ANAME="AEN15847"></A><P></P><TABLEBORDER="0"WIDTH="100%"BGCOLOR="#FFD0D0"CELLSPACING="0"CELLPADDING="4"CLASS="CALSTABLE"><TBODY><TR><TDWIDTH="20%"ALIGN="RIGHT"VALIGN="TOP"><TTCLASS="PARAMETER"><I>menu_item</I></TT> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">a <AHREF="gtkcheckmenuitem.html">GtkCheckMenuItem</A>.</TD></TR><TR><TDWIDTH="20%"ALIGN="RIGHT"VALIGN="TOP"><TTCLASS="PARAMETER"><I>always</I></TT> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">boolean value indicating whether to always show the check box. </TD></TR></TBODY></TABLE><P></P></DIV></DIV><HR><DIVCLASS="REFSECT2"><ANAME="AEN15861"></A><H3><ANAME="GTK-CHECK-MENU-ITEM-TOGGLED"></A>gtk_check_menu_item_toggled ()</H3><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="PROGRAMLISTING">void gtk_check_menu_item_toggled (<AHREF="gtkcheckmenuitem.html">GtkCheckMenuItem</A> *check_menu_item);</PRE></TD></TR></TABLE><P>Emits the GtkCheckMenuItem::toggled signal.</P><DIVCLASS="INFORMALTABLE"><ANAME="AEN15867"></A><P></P><TABLEBORDER="0"WIDTH="100%"BGCOLOR="#FFD0D0"CELLSPACING="0"CELLPADDING="4"CLASS="CALSTABLE"><TBODY><TR><TDWIDTH="20%"ALIGN="RIGHT"VALIGN="TOP"><TTCLASS="PARAMETER"><I>check_menu_item</I></TT> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">a <AHREF="gtkcheckmenuitem.html">GtkCheckMenuItem</A>. </TD></TR></TBODY></TABLE><P></P></DIV></DIV></DIV><DIVCLASS="REFSECT1"><ANAME="AEN15877"></A><H2>Signals</H2><DIVCLASS="REFSECT2"><ANAME="AEN15879"></A><H3><ANAME="GTKCHECKMENUITEM-TOGGLED"></A>The "toggled" signal</H3><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="PROGRAMLISTING">void user_function (<AHREF="gtkcheckmenuitem.html">GtkCheckMenuItem</A> *checkmenuitem, <AHREF=../glib/glib-basic-types.html#GPOINTER>gpointer</A> user_data);</PRE></TD></TR></TABLE><P>This signal is emitted when the state of the check box is changed.</P><P>A signal handler can examine the <TTCLASS="STRUCTFIELD"><I>active</I></TT> field of the <AHREF="gtkcheckmenuitem.html#GTKCHECKMENUITEM-STRUCT">GtkCheckMenuItem</A> struct to discover the new state.</P><DIVCLASS="INFORMALTABLE"><ANAME="AEN15889"></A><P></P><TABLEBORDER="0"WIDTH="100%"BGCOLOR="#FFD0D0"CELLSPACING="0"CELLPADDING="4"CLASS="CALSTABLE"><TBODY><TR><TDWIDTH="20%"ALIGN="RIGHT"VALIGN="TOP"><TTCLASS="PARAMETER"><I>checkmenuitem</I></TT> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">the object which received the signal. </TD></TR><TR><TDWIDTH="20%"ALIGN="RIGHT"VALIGN="TOP"><TTCLASS="PARAMETER"><I>user_data</I></TT> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">user data set when the signal handler was connected.</TD></TR></TBODY></TABLE><P></P></DIV></DIV></DIV><DIVCLASS="NAVFOOTER"><BRCLEAR="all"><BR><TABLEWIDTH="100%"BORDER="0"BGCOLOR="#000000"CELLPADDING="1"CELLSPACING="0"><TR><TDWIDTH="25%"BGCOLOR="#C00000"ALIGN="left"><AHREF="gtkcheckbutton.html"><FONTCOLOR="#FFFFFF"SIZE="3"><B><<< Previous Page</B></FONT></A></TD><TDWIDTH="25%"BGCOLOR="#0000C0"ALIGN="center"><FONTCOLOR="#FFFFFF"SIZE="3"><B><AHREF="index.html"><FONTCOLOR="#FFFFFF"SIZE="3"><B>Home</B></FONT></A></B></FONT></TD><TDWIDTH="25%"BGCOLOR="#00C000"ALIGN="center"><FONTCOLOR="#FFFFFF"SIZE="3"><B><AHREF="gtkobjects.html"><FONTCOLOR="#FFFFFF"SIZE="3"><B>Up</B></FONT></A></B></FONT></TD><TDWIDTH="25%"BGCOLOR="#C00000"ALIGN="right"><AHREF="gtkclist.html"><FONTCOLOR="#FFFFFF"SIZE="3"><B>Next Page >>></B></FONT></A></TD></TR><TR><TDCOLSPAN="2"ALIGN="left"><FONTCOLOR="#FFFFFF"SIZE="3"><B>GtkCheckButton</B></FONT></TD><TDCOLSPAN="2"ALIGN="right"><FONTCOLOR="#FFFFFF"SIZE="3"><B>GtkCList</B></FONT></TD></TR></TABLE></DIV></BODY></HTML>⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -