gtkmenu.html

最新gtk中文资料集

</pre>
</div>
<div class="refsect1" lang="en">
<a name="id3883765"></a><h2>Style Properties</h2>
<pre class="synopsis">

  "<a class="link" href="GtkMenu.html#GtkMenu--double-arrows">double-arrows</a>"            <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>              : Read
  "<a class="link" href="GtkMenu.html#GtkMenu--horizontal-offset">horizontal-offset</a>"        <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a>                  : Read
  "<a class="link" href="GtkMenu.html#GtkMenu--horizontal-padding">horizontal-padding</a>"       <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a>                  : Read
  "<a class="link" href="GtkMenu.html#GtkMenu--vertical-offset">vertical-offset</a>"          <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a>                  : Read
  "<a class="link" href="GtkMenu.html#GtkMenu--vertical-padding">vertical-padding</a>"         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a>                  : Read
</pre>
</div>
<div class="refsect1" lang="en">
<a name="id3883864"></a><h2>Signals</h2>
<pre class="synopsis">

  "<a class="link" href="GtkMenu.html#GtkMenu-move-scroll">move-scroll</a>"                                    : Run Last / Action
</pre>
</div>
<div class="refsect1" lang="en">
<a name="id3883892"></a><h2>Description</h2>
<p>
A <a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> is a <a class="link" href="GtkMenuShell.html" title="GtkMenuShell"><span class="type">GtkMenuShell</span></a> that implements a drop down menu consisting of
a list of <a class="link" href="GtkMenuItem.html" title="GtkMenuItem"><span class="type">GtkMenuItem</span></a> objects which can be navigated and activated by the 
user to perform application functions.
</p>
<p>
A <a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> is most commonly dropped down by activating a <a class="link" href="GtkMenuItem.html" title="GtkMenuItem"><span class="type">GtkMenuItem</span></a> in a 
<a class="link" href="GtkMenuBar.html" title="GtkMenuBar"><span class="type">GtkMenuBar</span></a> or popped up by activating a <a class="link" href="GtkMenuItem.html" title="GtkMenuItem"><span class="type">GtkMenuItem</span></a> in another <a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a>.  
</p>
<p>
A <a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> can also be popped up by activating a <a class="link" href="GtkOptionMenu.html" title="GtkOptionMenu"><span class="type">GtkOptionMenu</span></a>.  
Other composite widgets such as the <a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a> can pop up a <a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> 
as well.
</p>
<p>
Applications can display a <a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> as a popup menu by calling the 
<a class="link" href="GtkMenu.html#gtk-menu-popup"><code class="function">gtk_menu_popup()</code></a> function.  The example below shows how an application
can pop up a menu when the 3rd mouse button is pressed.  
</p>
<div class="example">
<a name="id3884038"></a><p class="title"><b>Example&#160;24.&#160;Connecting the popup signal handler.</b></p>
<div class="example-contents"><pre class="programlisting">
    /* connect our handler which will popup the menu */
    g_signal_connect_swapped (window, "button_press_event",
	G_CALLBACK (my_popup_handler), menu);
</pre></div>
</div>
<br class="example-break"><div class="example">
<a name="id3884053"></a><p class="title"><b>Example&#160;25.&#160;Signal handler which displays a popup menu.</b></p>
<div class="example-contents"><pre class="programlisting">
static gint
my_popup_handler (GtkWidget *widget, GdkEvent *event)
{
  GtkMenu *menu;
  GdkEventButton *event_button;

  g_return_val_if_fail (widget != NULL, FALSE);
  g_return_val_if_fail (GTK_IS_MENU (widget), FALSE);
  g_return_val_if_fail (event != NULL, FALSE);

  /* The "widget" is the menu that was supplied when 
   * g_signal_connect_swapped() was called.
   */
  menu = GTK_MENU (widget);

  if (event-&gt;type == GDK_BUTTON_PRESS)
    {
      event_button = (GdkEventButton *) event;
      if (event_button-&gt;button == 3)
	{
	  gtk_menu_popup (menu, NULL, NULL, NULL, NULL, 
			  event_button-&gt;button, event_button-&gt;time);
	  return TRUE;
	}
    }

  return FALSE;
}
</pre></div>
</div>
<br class="example-break">
</div>
<div class="refsect1" lang="en">
<a name="id3884079"></a><h2>Details</h2>
<div class="refsect2" lang="en">
<a name="id3884089"></a><h3>
<a name="GtkMenu-struct"></a>GtkMenu</h3>
<a class="indexterm" name="id3884102"></a><pre class="programlisting">typedef struct _GtkMenu GtkMenu;</pre>
<p>
The <a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> struct contains private data only, and
should be accessed using the functions below.
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3884127"></a><h3>
<a name="gtk-menu-new"></a>gtk_menu_new ()</h3>
<a class="indexterm" name="id3884140"></a><pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a>*          gtk_menu_new                        (void);</pre>
<p>
Creates a new <a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td>a new <a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a>.


</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3884192"></a><h3>
<a name="gtk-menu-set-screen"></a>gtk_menu_set_screen ()</h3>
<a class="indexterm" name="id3884208"></a><pre class="programlisting">void                gtk_menu_set_screen                 (<a class="link" href="GtkMenu.html" title="GtkMenu">GtkMenu</a> *menu,
                                                         <a
href="/usr/share/gtk-doc/html/gdk/GdkScreen.html"
>GdkScreen</a> *screen);</pre>
<p>
Sets the <a
href="/usr/share/gtk-doc/html/gdk/GdkScreen.html"
><span class="type">GdkScreen</span></a> on which the menu will be displayed.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>menu</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>screen</code></em>&#160;:</span></p></td>
<td> a <a
href="/usr/share/gtk-doc/html/gdk/GdkScreen.html"
><span class="type">GdkScreen</span></a>, or <a
href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"
><code class="literal">NULL</code></a> if the screen should be
         determined by the widget the menu is attached to.
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since  2.2
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3884321"></a><h3>
<a name="gtk-menu-append"></a>gtk_menu_append()</h3>
<a class="indexterm" name="id3884336"></a><pre class="programlisting">#define gtk_menu_append(menu,child)	gtk_menu_shell_append  ((GtkMenuShell *)(menu),(child))
</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_menu_append</code> is deprecated and should not be used in newly-written code. Use <a class="link" href="GtkMenuShell.html#gtk-menu-shell-append"><code class="function">gtk_menu_shell_append()</code></a> instead.</p>
</div>
<p>
Adds a new <a class="link" href="GtkMenuItem.html" title="GtkMenuItem"><span class="type">GtkMenuItem</span></a> to the end of the menu's item list.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>menu</code></em>&#160;:</span></p></td>
<td>a <a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>child</code></em>&#160;:</span></p></td>
<td>The <a class="link" href="GtkMenuItem.html" title="GtkMenuItem"><span class="type">GtkMenuItem</span></a> to add.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3884433"></a><h3>
<a name="gtk-menu-prepend"></a>gtk_menu_prepend()</h3>
<a class="indexterm" name="id3884449"></a><pre class="programlisting">#define gtk_menu_prepend(menu,child)    gtk_menu_shell_prepend ((GtkMenuShell *)(menu),(child))
</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_menu_prepend</code> is deprecated and should not be used in newly-written code. Use <a class="link" href="GtkMenuShell.html#gtk-menu-shell-prepend"><code class="function">gtk_menu_shell_prepend()</code></a> instead.</p>
</div>
<p>
Adds a new <a class="link" href="GtkMenuItem.html" title="GtkMenuItem"><span class="type">GtkMenuItem</span></a> to the beginning of the menu's item list.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>menu</code></em>&#160;:</span></p></td>
<td>a <a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>child</code></em>&#160;:</span></p></td>
<td>The <a class="link" href="GtkMenuItem.html" title="GtkMenuItem"><span class="type">GtkMenuItem</span></a> to add.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3884547"></a><h3>
<a name="gtk-menu-insert"></a>gtk_menu_insert()</h3>
<a class="indexterm" name="id3884563"></a><pre class="programlisting">#define gtk_menu_insert(menu,child,pos)	gtk_menu_shell_insert ((GtkMenuShell *)(menu),(child),(pos))
</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_menu_insert</code> is deprecated and should not be used in newly-written code. Use <a class="link" href="GtkMenuShell.html#gtk-menu-shell-insert"><code class="function">gtk_menu_shell_insert()</code></a> instead.</p>
</div>
<p>
Adds a new <a class="link" href="GtkMenuItem.html" title="GtkMenuItem"><span class="type">GtkMenuItem</span></a> to the menu's item list at the position
indicated by <em class="parameter"><code>position</code></em>. 
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>menu</code></em>&#160;:</span></p></td>
<td>a <a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>child</code></em>&#160;:</span></p></td>
<td>The <a class="link" href="GtkMenuItem.html" title="GtkMenuItem"><span class="type">GtkMenuItem</span></a> to add.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>pos</code></em>&#160;:</span></p></td>
<td>The position in the item list where <em class="parameter"><code>child</code></em> is added.
      Positions are numbered from 0 to n-1.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>