📄 gtkmenuitem.html
字号:
<HTML><HEAD><TITLE>GtkMenuItem</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="GtkMenuBar"HREF="gtkmenubar.html"><LINKREL="NEXT"TITLE="GtkMenuShell"HREF="gtkmenushell.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="gtkmenubar.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="gtkmenushell.html"><FONTCOLOR="#FFFFFF"SIZE="3"><B>Next Page >>></B></FONT></A></TD></TR></TABLE></DIV><H1><ANAME="GTKMENUITEM">GtkMenuItem</A></H1><DIVCLASS="REFNAMEDIV"><ANAME="AEN31498"></A><H2>Name</H2>GtkMenuItem -- the widget used for item in menus</DIV><DIVCLASS="REFSYNOPSISDIV"><ANAME="AEN31501"></A><H2>Synopsis</H2><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="SYNOPSIS"> #include <gtk/gtk.h>struct <AHREF="gtkmenuitem.html#GTKMENUITEM-STRUCT">GtkMenuItem</A>;<AHREF="gtkwidget.html">GtkWidget</A>* <AHREF="gtkmenuitem.html#GTK-MENU-ITEM-NEW">gtk_menu_item_new</A> (void);<AHREF="gtkwidget.html">GtkWidget</A>* <AHREF="gtkmenuitem.html#GTK-MENU-ITEM-NEW-WITH-LABEL">gtk_menu_item_new_with_label</A> (const <AHREF=../glib/glib-basic-types.html#GCHAR>gchar</A> *label);void <AHREF="gtkmenuitem.html#GTK-MENU-ITEM-SET-SUBMENU">gtk_menu_item_set_submenu</A> (<AHREF="gtkmenuitem.html">GtkMenuItem</A> *menu_item, <AHREF="gtkwidget.html">GtkWidget</A> *submenu);void <AHREF="gtkmenuitem.html#GTK-MENU-ITEM-REMOVE-SUBMENU">gtk_menu_item_remove_submenu</A> (<AHREF="gtkmenuitem.html">GtkMenuItem</A> *menu_item);void <AHREF="gtkmenuitem.html#GTK-MENU-ITEM-SET-PLACEMENT">gtk_menu_item_set_placement</A> (<AHREF="gtkmenuitem.html">GtkMenuItem</A> *menu_item, <AHREF="gtk-standard-enumerations.html#GTKSUBMENUPLACEMENT">GtkSubmenuPlacement</A> placement);void <AHREF="gtkmenuitem.html#GTK-MENU-ITEM-CONFIGURE">gtk_menu_item_configure</A> (<AHREF="gtkmenuitem.html">GtkMenuItem</A> *menu_item, <AHREF=../glib/glib-basic-types.html#GINT>gint</A> show_toggle_indicator, <AHREF=../glib/glib-basic-types.html#GINT>gint</A> show_submenu_indicator);void <AHREF="gtkmenuitem.html#GTK-MENU-ITEM-SELECT">gtk_menu_item_select</A> (<AHREF="gtkmenuitem.html">GtkMenuItem</A> *menu_item);void <AHREF="gtkmenuitem.html#GTK-MENU-ITEM-DESELECT">gtk_menu_item_deselect</A> (<AHREF="gtkmenuitem.html">GtkMenuItem</A> *menu_item);void <AHREF="gtkmenuitem.html#GTK-MENU-ITEM-ACTIVATE">gtk_menu_item_activate</A> (<AHREF="gtkmenuitem.html">GtkMenuItem</A> *menu_item);void <AHREF="gtkmenuitem.html#GTK-MENU-ITEM-RIGHT-JUSTIFY">gtk_menu_item_right_justify</A> (<AHREF="gtkmenuitem.html">GtkMenuItem</A> *menu_item); </PRE></TD></TR></TABLE></DIV><DIVCLASS="REFSECT1"><ANAME="AEN31530"></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> +----GtkMenuItem</PRE></TD></TR></TABLE></DIV><DIVCLASS="REFSECT1"><ANAME="AEN31538"></A><H2>Signal Prototypes</H2><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="SYNOPSIS"> "<AHREF="gtkmenuitem.html#GTKMENUITEM-ACTIVATE">activate</A>" void user_function (<AHREF="gtkmenuitem.html">GtkMenuItem</A> *menuitem, <AHREF=../glib/glib-basic-types.html#GPOINTER>gpointer</A> user_data);"<AHREF="gtkmenuitem.html#GTKMENUITEM-ACTIVATE-ITEM">activate-item</A>" void user_function (<AHREF="gtkmenuitem.html">GtkMenuItem</A> *menuitem, <AHREF=../glib/glib-basic-types.html#GPOINTER>gpointer</A> user_data);</PRE></TD></TR></TABLE></DIV><DIVCLASS="REFSECT1"><ANAME="AEN31547"></A><H2>Description</H2><P>The <AHREF="gtkmenuitem.html">GtkMenuItem</A> widget and the derived widgets are the only validchilds for menus. Their function is to correctly handle highlighting,alignment, events and submenus.</P><P>As it derives from <AHREF="gtkbin.html">GtkBin</A> it can hold any valid child widget, altoughonly a few are really useful.</P></DIV><DIVCLASS="REFSECT1"><ANAME="AEN31553"></A><H2>Details</H2><DIVCLASS="REFSECT2"><ANAME="AEN31555"></A><H3><ANAME="GTKMENUITEM-STRUCT"></A>struct GtkMenuItem</H3><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="PROGRAMLISTING">struct GtkMenuItem;</PRE></TD></TR></TABLE><P></P><DIVCLASS="INFORMALTABLE"><ANAME="AEN31560"></A><P></P><TABLEBORDER="0"WIDTH="100%"BGCOLOR="#FFF0D0"CELLSPACING="0"CELLPADDING="4"CLASS="CALSTABLE"><TBODY></TBODY></TABLE><P></P></DIV></DIV><HR><DIVCLASS="REFSECT2"><ANAME="AEN31565"></A><H3><ANAME="GTK-MENU-ITEM-NEW"></A>gtk_menu_item_new ()</H3><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="PROGRAMLISTING"><AHREF="gtkwidget.html">GtkWidget</A>* gtk_menu_item_new (void);</PRE></TD></TR></TABLE><P>Creates a new <AHREF="gtkmenuitem.html">GtkMenuItem</A>.</P><DIVCLASS="INFORMALTABLE"><ANAME="AEN31572"></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">the newly created <AHREF="gtkmenuitem.html">GtkMenuItem</A> </TD></TR></TBODY></TABLE><P></P></DIV></DIV><HR><DIVCLASS="REFSECT2"><ANAME="AEN31582"></A><H3><ANAME="GTK-MENU-ITEM-NEW-WITH-LABEL"></A>gtk_menu_item_new_with_label ()</H3><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="PROGRAMLISTING"><AHREF="gtkwidget.html">GtkWidget</A>* gtk_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="gtkmenuitem.html">GtkMenuItem</A> whose child is a simple GtlLabel.</P><DIVCLASS="INFORMALTABLE"><ANAME="AEN31591"></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 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 <AHREF="gtkmenuitem.html">GtkMenuItem</A> </TD></TR></TBODY></TABLE><P></P></DIV></DIV><HR><DIVCLASS="REFSECT2"><ANAME="AEN31605"></A><H3><ANAME="GTK-MENU-ITEM-SET-SUBMENU"></A>gtk_menu_item_set_submenu ()</H3><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="PROGRAMLISTING">void gtk_menu_item_set_submenu (<AHREF="gtkmenuitem.html">GtkMenuItem</A> *menu_item, <AHREF="gtkwidget.html">GtkWidget</A> *submenu);</PRE></TD></TR></TABLE><P>Sets the widget submenu, or changes it.</P><DIVCLASS="INFORMALTABLE"><ANAME="AEN31612"></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">the menu item widget</TD></TR><TR><TDWIDTH="20%"ALIGN="RIGHT"VALIGN="TOP"><TTCLASS="PARAMETER"><I>submenu</I></TT> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">the submenu </TD></TR></TBODY></TABLE><P></P></DIV></DIV><HR><DIVCLASS="REFSECT2"><ANAME="AEN31625"></A><H3><ANAME="GTK-MENU-ITEM-REMOVE-SUBMENU"></A>gtk_menu_item_remove_submenu ()</H3><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="PROGRAMLISTING">void gtk_menu_item_remove_submenu (<AHREF="gtkmenuitem.html">GtkMenuItem</A> *menu_item);</PRE></TD></TR></TABLE><P>Removes the widget's submenu.</P><DIVCLASS="INFORMALTABLE"><ANAME="AEN31631"></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">the menu item widget </TD></TR></TBODY></TABLE><P></P></DIV></DIV><HR><DIVCLASS="REFSECT2"><ANAME="AEN31640"></A><H3><ANAME="GTK-MENU-ITEM-SET-PLACEMENT"></A>gtk_menu_item_set_placement ()</H3><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="PROGRAMLISTING">void gtk_menu_item_set_placement (<AHREF="gtkmenuitem.html">GtkMenuItem</A> *menu_item, <AHREF="gtk-standard-enumerations.html#GTKSUBMENUPLACEMENT">GtkSubmenuPlacement</A> placement);</PRE></TD></TR></TABLE><P>Specifies the placement of the submenu around the menu item. The placementis usually GTK_LEFT_RIGHT for menu items in a popup menu andGTK_TOP_BOTTOM in menu bars.</P><P>This function is useless in usual applications.</P><DIVCLASS="INFORMALTABLE"><ANAME="AEN31650"></A><P></P><TABLEBORDER="0"WIDTH="100%"BGCOLOR="#FFD0D0"CELLSPACING="0"⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -