📄 gtkradiomenuitem.html
字号:
<HTML><HEAD><TITLE>GtkRadioMenuItem</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="GtkRadioButton"HREF="gtkradiobutton.html"><LINKREL="NEXT"TITLE="GtkRange"HREF="gtkrange.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="gtkradiobutton.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="gtkrange.html"><FONTCOLOR="#FFFFFF"SIZE="3"><B>Next Page >>></B></FONT></A></TD></TR></TABLE></DIV><H1><ANAME="GTKRADIOMENUITEM">GtkRadioMenuItem</A></H1><DIVCLASS="REFNAMEDIV"><ANAME="AEN37719"></A><H2>Name</H2>GtkRadioMenuItem -- A choice from multiple check menu items.</DIV><DIVCLASS="REFSYNOPSISDIV"><ANAME="AEN37722"></A><H2>Synopsis</H2><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="SYNOPSIS"> #include <gtk/gtk.h>struct <AHREF="gtkradiomenuitem.html#GTKRADIOMENUITEM-STRUCT">GtkRadioMenuItem</A>;<AHREF="gtkwidget.html">GtkWidget</A>* <AHREF="gtkradiomenuitem.html#GTK-RADIO-MENU-ITEM-NEW">gtk_radio_menu_item_new</A> (<AHREF=../glib/glib-singly-linked-lists.html#GSLIST>GSList</A> *group);<AHREF="gtkwidget.html">GtkWidget</A>* <AHREF="gtkradiomenuitem.html#GTK-RADIO-MENU-ITEM-NEW-WITH-LABEL">gtk_radio_menu_item_new_with_label</A> (<AHREF=../glib/glib-singly-linked-lists.html#GSLIST>GSList</A> *group, const <AHREF=../glib/glib-basic-types.html#GCHAR>gchar</A> *label);<AHREF=../glib/glib-singly-linked-lists.html#GSLIST>GSList</A>* <AHREF="gtkradiomenuitem.html#GTK-RADIO-MENU-ITEM-GROUP">gtk_radio_menu_item_group</A> (<AHREF="gtkradiomenuitem.html">GtkRadioMenuItem</A> *radio_menu_item);void <AHREF="gtkradiomenuitem.html#GTK-RADIO-MENU-ITEM-SET-GROUP">gtk_radio_menu_item_set_group</A> (<AHREF="gtkradiomenuitem.html">GtkRadioMenuItem</A> *radio_menu_item, <AHREF=../glib/glib-singly-linked-lists.html#GSLIST>GSList</A> *group); </PRE></TD></TR></TABLE></DIV><DIVCLASS="REFSECT1"><ANAME="AEN37739"></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> +----<AHREF="gtkcheckmenuitem.html">GtkCheckMenuItem</A> +----GtkRadioMenuItem</PRE></TD></TR></TABLE></DIV><DIVCLASS="REFSECT1"><ANAME="AEN37749"></A><H2>Description</H2><P>A radio menu item is a check menu item that belongs to a group. At eachinstant exactly one of the radio menu items from a group is selected.</P><P>The correct way to create a group of radio menu items is aproximativlythis:</P><P><DIVCLASS="EXAMPLE"><ANAME="AEN37754"></A><P><B>Example 1. How to create a group of radio menu items.</B></P><TABLEBORDER="0"BGCOLOR="#D8F8D8"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="PROGRAMLISTING">GList *group = NULL;GtkWidget *item;gint i;for(i = 0; i < 5; i++){ item = gtk_radio_menu_item_new_with_label (group, "This is an example"); group = gtk_radio_menu_item_group (GTK_RADIO_MENU_ITEM (item)); if (i == 1) gtk_check_menu_item_set_active (GTK_CHECK_MENU_ITEM (item), TRUE);}</PRE></TD></TR></TABLE></DIV></P></DIV><DIVCLASS="REFSECT1"><ANAME="AEN37757"></A><H2>Details</H2><DIVCLASS="REFSECT2"><ANAME="AEN37759"></A><H3><ANAME="GTKRADIOMENUITEM-STRUCT"></A>struct GtkRadioMenuItem</H3><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="PROGRAMLISTING">struct GtkRadioMenuItem;</PRE></TD></TR></TABLE><P>The structure contains only provate data that must be accessed throughthe interface functions.</P></DIV><HR><DIVCLASS="REFSECT2"><ANAME="AEN37764"></A><H3><ANAME="GTK-RADIO-MENU-ITEM-NEW"></A>gtk_radio_menu_item_new ()</H3><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="PROGRAMLISTING"><AHREF="gtkwidget.html">GtkWidget</A>* gtk_radio_menu_item_new (<AHREF=../glib/glib-singly-linked-lists.html#GSLIST>GSList</A> *group);</PRE></TD></TR></TABLE><P>Creates a new <AHREF="gtkradiomenuitem.html">GtkRadioMenuItem</A>.</P><DIVCLASS="INFORMALTABLE"><ANAME="AEN37772"></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>group</I></TT> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">the group to wich the radio menu item is to be attached</TD></TR><TR><TDWIDTH="20%"ALIGN="RIGHT"VALIGN="TOP"><ICLASS="EMPHASIS">Returns</I> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">the newly created radio menu item </TD></TR></TBODY></TABLE><P></P></DIV></DIV><HR><DIVCLASS="REFSECT2"><ANAME="AEN37785"></A><H3><ANAME="GTK-RADIO-MENU-ITEM-NEW-WITH-LABEL"></A>gtk_radio_menu_item_new_with_label ()</H3><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="PROGRAMLISTING"><AHREF="gtkwidget.html">GtkWidget</A>* gtk_radio_menu_item_new_with_label (<AHREF=../glib/glib-singly-linked-lists.html#GSLIST>GSList</A> *group, const <AHREF=../glib/glib-basic-types.html#GCHAR>gchar</A> *label);</PRE></TD></TR></TABLE><P>Creates a new <AHREF="gtkradiomenuitem.html">GtkRadioMenuItem</A> whose child is a simple GtlLabel.</P><DIVCLASS="INFORMALTABLE"><ANAME="AEN37795"></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>group</I></TT> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">the group to wich the radio menu item is to be attached</TD></TR><TR><TDWIDTH="20%"ALIGN="RIGHT"VALIGN="TOP"><TTCLASS="PARAMETER"><I>label</I></TT> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">the text for the label</TD></TR><TR><TDWIDTH="20%"ALIGN="RIGHT"VALIGN="TOP"><ICLASS="EMPHASIS">Returns</I> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">the newly created radio menu item </TD></TR></TBODY></TABLE><P></P></DIV></DIV><HR><DIVCLASS="REFSECT2"><ANAME="AEN37812"></A><H3><ANAME="GTK-RADIO-MENU-ITEM-GROUP"></A>gtk_radio_menu_item_group ()</H3><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="PROGRAMLISTING"><AHREF=../glib/glib-singly-linked-lists.html#GSLIST>GSList</A>* gtk_radio_menu_item_group (<AHREF="gtkradiomenuitem.html">GtkRadioMenuItem</A> *radio_menu_item);</PRE></TD></TR></TABLE><P>Returns the group to which the radio menu item belongs, as a <AHREF=../glib/glib-doubly-linked-lists.html#GLIST>GList</A> of<AHREF="gtkradiomenuitem.html">GtkRadioMenuItem</A>. The list belongs to GTK+ and should not be freed.</P><DIVCLASS="INFORMALTABLE"><ANAME="AEN37821"></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>radio_menu_item</I></TT> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">the radio menu item</TD></TR><TR><TDWIDTH="20%"ALIGN="RIGHT"VALIGN="TOP"><ICLASS="EMPHASIS">Returns</I> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">its group </TD></TR></TBODY></TABLE><P></P></DIV></DIV><HR><DIVCLASS="REFSECT2"><ANAME="AEN37834"></A><H3><ANAME="GTK-RADIO-MENU-ITEM-SET-GROUP"></A>gtk_radio_menu_item_set_group ()</H3><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="PROGRAMLISTING">void gtk_radio_menu_item_set_group (<AHREF="gtkradiomenuitem.html">GtkRadioMenuItem</A> *radio_menu_item, <AHREF=../glib/glib-singly-linked-lists.html#GSLIST>GSList</A> *group);</PRE></TD></TR></TABLE><P>Sets the group of a radio menu item, or changes it.</P><DIVCLASS="INFORMALTABLE"><ANAME="AEN37841"></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>radio_menu_item</I></TT> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">the radio menu item</TD></TR><TR><TDWIDTH="20%"ALIGN="RIGHT"VALIGN="TOP"><TTCLASS="PARAMETER"><I>group</I></TT> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">the new group </TD></TR></TBODY></TABLE><P></P></DIV></DIV></DIV><DIVCLASS="REFSECT1"><ANAME="AEN37854"></A><H2>See Also</H2><P><P></P><DIVCLASS="VARIABLELIST"><DL><DT><AHREF="gtkmenuitem.html">GtkMenuItem</A></DT><DD><P>because a radio menu item is a menu item.</P></DD><DT>GtkCheckItem</DT><DD><P>to know how to handle the check.</P></DD></DL></DIV></P></DIV><DIVCLASS="NAVFOOTER"><BRCLEAR="all"><BR><TABLEWIDTH="100%"BORDER="0"BGCOLOR="#000000"CELLPADDING="1"CELLSPACING="0"><TR><TDWIDTH="25%"BGCOLOR="#C00000"ALIGN="left"><AHREF="gtkradiobutton.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="gtkrange.html"><FONTCOLOR="#FFFFFF"SIZE="3"><B>Next Page >>></B></FONT></A></TD></TR><TR><TDCOLSPAN="2"ALIGN="left"><FONTCOLOR="#FFFFFF"SIZE="3"><B>GtkRadioButton</B></FONT></TD><TDCOLSPAN="2"ALIGN="right"><FONTCOLOR="#FFFFFF"SIZE="3"><B>GtkRange</B></FONT></TD></TR></TABLE></DIV></BODY></HTML>⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -