📄 gtkmenushell.html
字号:
<HTML><HEAD><TITLE>GtkMenuShell</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="GtkMenuItem"HREF="gtkmenuitem.html"><LINKREL="NEXT"TITLE="GtkMisc"HREF="gtkmisc.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="gtkmenuitem.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="gtkmisc.html"><FONTCOLOR="#FFFFFF"SIZE="3"><B>Next Page >>></B></FONT></A></TD></TR></TABLE></DIV><H1><ANAME="GTKMENUSHELL">GtkMenuShell</A></H1><DIVCLASS="REFNAMEDIV"><ANAME="AEN31817"></A><H2>Name</H2>GtkMenuShell -- a base class for menu objects.</DIV><DIVCLASS="REFSYNOPSISDIV"><ANAME="AEN31820"></A><H2>Synopsis</H2><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="SYNOPSIS"> #include <gtk/gtk.h>struct <AHREF="gtkmenushell.html#GTKMENUSHELL-STRUCT">GtkMenuShell</A>;void <AHREF="gtkmenushell.html#GTK-MENU-SHELL-APPEND">gtk_menu_shell_append</A> (<AHREF="gtkmenushell.html">GtkMenuShell</A> *menu_shell, <AHREF="gtkwidget.html">GtkWidget</A> *child);void <AHREF="gtkmenushell.html#GTK-MENU-SHELL-PREPEND">gtk_menu_shell_prepend</A> (<AHREF="gtkmenushell.html">GtkMenuShell</A> *menu_shell, <AHREF="gtkwidget.html">GtkWidget</A> *child);void <AHREF="gtkmenushell.html#GTK-MENU-SHELL-INSERT">gtk_menu_shell_insert</A> (<AHREF="gtkmenushell.html">GtkMenuShell</A> *menu_shell, <AHREF="gtkwidget.html">GtkWidget</A> *child, <AHREF=../glib/glib-basic-types.html#GINT>gint</A> position);void <AHREF="gtkmenushell.html#GTK-MENU-SHELL-DEACTIVATE">gtk_menu_shell_deactivate</A> (<AHREF="gtkmenushell.html">GtkMenuShell</A> *menu_shell);void <AHREF="gtkmenushell.html#GTK-MENU-SHELL-SELECT-ITEM">gtk_menu_shell_select_item</A> (<AHREF="gtkmenushell.html">GtkMenuShell</A> *menu_shell, <AHREF="gtkwidget.html">GtkWidget</A> *menu_item);void <AHREF="gtkmenushell.html#GTK-MENU-SHELL-ACTIVATE-ITEM">gtk_menu_shell_activate_item</A> (<AHREF="gtkmenushell.html">GtkMenuShell</A> *menu_shell, <AHREF="gtkwidget.html">GtkWidget</A> *menu_item, <AHREF=../glib/glib-basic-types.html#GBOOLEAN>gboolean</A> force_deactivate);enum <AHREF="gtkmenushell.html#GTKMENUDIRECTIONTYPE">GtkMenuDirectionType</A>; </PRE></TD></TR></TABLE></DIV><DIVCLASS="REFSECT1"><ANAME="AEN31844"></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> +----GtkMenuShell</PRE></TD></TR></TABLE></DIV><DIVCLASS="REFSECT1"><ANAME="AEN31850"></A><H2>Signal Prototypes</H2><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="SYNOPSIS"> "<AHREF="gtkmenushell.html#GTKMENUSHELL-DEACTIVATE">deactivate</A>" void user_function (<AHREF="gtkmenushell.html">GtkMenuShell</A> *menushell, <AHREF=../glib/glib-basic-types.html#GPOINTER>gpointer</A> user_data);"<AHREF="gtkmenushell.html#GTKMENUSHELL-SELECTION-DONE">selection-done</A>" void user_function (<AHREF="gtkmenushell.html">GtkMenuShell</A> *menushell, <AHREF=../glib/glib-basic-types.html#GPOINTER>gpointer</A> user_data);"<AHREF="gtkmenushell.html#GTKMENUSHELL-MOVE-CURRENT">move-current</A>" void user_function (<AHREF="gtkmenushell.html">GtkMenuShell</A> *menushell, <AHREF="gtkmenushell.html#GTKMENUDIRECTIONTYPE">GtkMenuDirectionType</A> direction, <AHREF=../glib/glib-basic-types.html#GPOINTER>gpointer</A> user_data);"<AHREF="gtkmenushell.html#GTKMENUSHELL-ACTIVATE-CURRENT">activate-current</A>" void user_function (<AHREF="gtkmenushell.html">GtkMenuShell</A> *menushell, <AHREF=../glib/glib-basic-types.html#GBOOLEAN>gboolean</A> force_hide, <AHREF=../glib/glib-basic-types.html#GPOINTER>gpointer</A> user_data);"<AHREF="gtkmenushell.html#GTKMENUSHELL-CANCEL">cancel</A>" void user_function (<AHREF="gtkmenushell.html">GtkMenuShell</A> *menushell, <AHREF=../glib/glib-basic-types.html#GPOINTER>gpointer</A> user_data);</PRE></TD></TR></TABLE></DIV><DIVCLASS="REFSECT1"><ANAME="AEN31870"></A><H2>Description</H2><P>A <AHREF="gtkmenushell.html">GtkMenuShell</A> is the abstract base class used to derive the <AHREF="gtkmenu.html">GtkMenu</A> and <AHREF="gtkmenubar.html">GtkMenuBar</A> subclasses. </P><P>A <AHREF="gtkmenushell.html">GtkMenuShell</A> is a container of <AHREF="gtkmenuitem.html">GtkMenuItem</A> objects arranged in a list which can be navigated, selected, and activated by the user to performapplication functions. A <AHREF="gtkmenuitem.html">GtkMenuItem</A> can have a submenu associated with it,allowing for nested hierarchical menus.</P></DIV><DIVCLASS="REFSECT1"><ANAME="AEN31880"></A><H2>Details</H2><DIVCLASS="REFSECT2"><ANAME="AEN31882"></A><H3><ANAME="GTKMENUSHELL-STRUCT"></A>struct GtkMenuShell</H3><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="PROGRAMLISTING">struct GtkMenuShell;</PRE></TD></TR></TABLE><P>The <AHREF="gtkmenushell.html#GTKMENUSHELL-STRUCT">GtkMenuShell</A> struct contains the following fields.(These fields should be considered read-only. They should never be set byan application.)<DIVCLASS="INFORMALTABLE"><ANAME="AEN31888"></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-doubly-linked-lists.html#GLIST>GList</A> *children;</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">The list of <AHREF="gtkmenuitem.html">GtkMenuItem</A> objects contained by this <AHREF="gtkmenushell.html">GtkMenuShell</A>.</TD></TR></TBODY></TABLE><P></P></DIV></P></DIV><HR><DIVCLASS="REFSECT2"><ANAME="AEN31899"></A><H3><ANAME="GTK-MENU-SHELL-APPEND"></A>gtk_menu_shell_append ()</H3><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="PROGRAMLISTING">void gtk_menu_shell_append (<AHREF="gtkmenushell.html">GtkMenuShell</A> *menu_shell, <AHREF="gtkwidget.html">GtkWidget</A> *child);</PRE></TD></TR></TABLE><P>Adds a new <AHREF="gtkmenuitem.html">GtkMenuItem</A> to the end of the menu shell's item list.</P><DIVCLASS="INFORMALTABLE"><ANAME="AEN31907"></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_shell</I></TT> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">a <AHREF="gtkmenushell.html">GtkMenuShell</A>.</TD></TR><TR><TDWIDTH="20%"ALIGN="RIGHT"VALIGN="TOP"><TTCLASS="PARAMETER"><I>child</I></TT> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">The <AHREF="gtkmenuitem.html">GtkMenuItem</A> to add. </TD></TR></TBODY></TABLE><P></P></DIV></DIV><HR><DIVCLASS="REFSECT2"><ANAME="AEN31922"></A><H3><ANAME="GTK-MENU-SHELL-PREPEND"></A>gtk_menu_shell_prepend ()</H3><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="PROGRAMLISTING">void gtk_menu_shell_prepend (<AHREF="gtkmenushell.html">GtkMenuShell</A> *menu_shell, <AHREF="gtkwidget.html">GtkWidget</A> *child);</PRE></TD></TR></TABLE><P>Adds a new <AHREF="gtkmenuitem.html">GtkMenuItem</A> to the beginning of the menu shell's item list.</P><DIVCLASS="INFORMALTABLE"><ANAME="AEN31930"></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_shell</I></TT> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">a <AHREF="gtkmenushell.html">GtkMenuShell</A>.</TD></TR><TR><TDWIDTH="20%"ALIGN="RIGHT"VALIGN="TOP"><TTCLASS="PARAMETER"><I>child</I></TT> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">The <AHREF="gtkmenuitem.html">GtkMenuItem</A> to add. </TD></TR></TBODY></TABLE><P></P></DIV></DIV><HR><DIVCLASS="REFSECT2"><ANAME="AEN31945"></A><H3><ANAME="GTK-MENU-SHELL-INSERT"></A>gtk_menu_shell_insert ()</H3><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="PROGRAMLISTING">void gtk_menu_shell_insert (<AHREF="gtkmenushell.html">GtkMenuShell</A> *menu_shell, <AHREF="gtkwidget.html">GtkWidget</A> *child, <AHREF=../glib/glib-basic-types.html#GINT>gint</A> position);</PRE></TD></TR></TABLE><P>Adds a new <AHREF="gtkmenuitem.html">GtkMenuItem</A> to the menu shell's item list at the positionindicated by <TTCLASS="PARAMETER"><I>position</I></TT>. </P><DIVCLASS="INFORMALTABLE"><ANAME="AEN31955"></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_shell</I></TT> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">a <AHREF="gtkmenushell.html">GtkMenuShell</A>.</TD></TR><TR><TDWIDTH="20%"ALIGN="RIGHT"VALIGN="TOP"><TTCLASS="PARAMETER"><I>child</I></TT> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">The <AHREF="gtkmenuitem.html">GtkMenuItem</A> to add.</TD></TR><TR><TDWIDTH="20%"ALIGN="RIGHT"VALIGN="TOP"><TTCLASS="PARAMETER"><I>position</I></TT> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">The position in the item list where <TTCLASS="PARAMETER"><I>child</I></TT> is added.Positions are numbered from 0 to n-1. </TD></TR></TBODY></TABLE><P></P></DIV></DIV><HR><DIVCLASS="REFSECT2"><ANAME="AEN31975"></A><H3><ANAME="GTK-MENU-SHELL-DEACTIVATE"></A>gtk_menu_shell_deactivate ()</H3><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="PROGRAMLISTING">void gtk_menu_shell_deactivate (<AHREF="gtkmenushell.html">GtkMenuShell</A> *menu_shell);</PRE></TD></TR></TABLE><P>Deactivates the menu shell. Typically this results in the menu shellbeing erased from the screen.</P><DIVCLASS="INFORMALTABLE"><ANAME="AEN31981"></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_shell</I></TT> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">a <AHREF="gtkmenushell.html">GtkMenuShell</A>. </TD></TR></TBODY></TABLE><P></P></DIV></DIV><HR><DIVCLASS="REFSECT2"><ANAME="AEN31991"></A><H3><ANAME="GTK-MENU-SHELL-SELECT-ITEM"></A>gtk_menu_shell_select_item ()</H3><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="PROGRAMLISTING">void gtk_menu_shell_select_item (<AHREF="gtkmenushell.html">GtkMenuShell</A> *menu_shell, <AHREF="gtkwidget.html">GtkWidget</A> *menu_item);</PRE></TD
⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -