gtkmenuitem.html

最新gtk中文资料集

<tr>
<td><p><span class="term"><em class="parameter"><code>label</code></em>&#160;:</span></p></td>
<td> The text of the button, with an underscore in front of the
        mnemonic character
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> a new <a class="link" href="GtkMenuItem.html" title="GtkMenuItem"><span class="type">GtkMenuItem</span></a>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3897649"></a><h3>
<a name="gtk-menu-item-set-right-justified"></a>gtk_menu_item_set_right_justified ()</h3>
<a class="indexterm" name="id3897663"></a><pre class="programlisting">void                gtk_menu_item_set_right_justified   (<a class="link" href="GtkMenuItem.html" title="GtkMenuItem">GtkMenuItem</a> *menu_item,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> right_justified);</pre>
<p>
Sets whether the menu item appears justified at the right
side of a menu bar. This was traditionally done for "Help" menu
items, but is now considered a bad idea. (If the widget
layout is reversed for a right-to-left language like Hebrew
or Arabic, right-justified-menu-items appear at the left.)</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_item</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="GtkMenuItem.html" title="GtkMenuItem"><span class="type">GtkMenuItem</span></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>right_justified</code></em>&#160;:</span></p></td>
<td> if <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
><code class="literal">TRUE</code></a> the menu item will appear at the 
  far right if added to a menu bar.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3897758"></a><h3>
<a name="gtk-menu-item-set-submenu"></a>gtk_menu_item_set_submenu ()</h3>
<a class="indexterm" name="id3897772"></a><pre class="programlisting">void                gtk_menu_item_set_submenu           (<a class="link" href="GtkMenuItem.html" title="GtkMenuItem">GtkMenuItem</a> *menu_item,
                                                         <a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *submenu);</pre>
<p>
Sets or replaces the menu item's submenu, or removes it when a <a
href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"
><code class="literal">NULL</code></a>
submenu is passed.</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_item</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="GtkMenuItem.html" title="GtkMenuItem"><span class="type">GtkMenuItem</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>submenu</code></em>&#160;:</span></p></td>
<td> the submenu, or <a
href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"
><code class="literal">NULL</code></a>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3897872"></a><h3>
<a name="gtk-menu-item-set-accel-path"></a>gtk_menu_item_set_accel_path ()</h3>
<a class="indexterm" name="id3897886"></a><pre class="programlisting">void                gtk_menu_item_set_accel_path        (<a class="link" href="GtkMenuItem.html" title="GtkMenuItem">GtkMenuItem</a> *menu_item,
                                                         const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *accel_path);</pre>
<p>
Set the accelerator path on <em class="parameter"><code>menu_item</code></em>, through which runtime changes of the
menu item's accelerator caused by the user can be identified and saved to
persistant storage (see <a class="link" href="gtk-Accelerator-Maps.html#gtk-accel-map-save"><code class="function">gtk_accel_map_save()</code></a> on this).
To setup a default accelerator for this menu item, call
<a class="link" href="gtk-Accelerator-Maps.html#gtk-accel-map-add-entry"><code class="function">gtk_accel_map_add_entry()</code></a> with the same <em class="parameter"><code>accel_path</code></em>.
See also <a class="link" href="gtk-Accelerator-Maps.html#gtk-accel-map-add-entry"><code class="function">gtk_accel_map_add_entry()</code></a> on the specifics of accelerator paths,
and <a class="link" href="GtkMenu.html#gtk-menu-set-accel-path"><code class="function">gtk_menu_set_accel_path()</code></a> for a more convenient variant of this function.
</p>
<p>
This function is basically a convenience wrapper that handles calling
<a class="link" href="GtkWidget.html#gtk-widget-set-accel-path"><code class="function">gtk_widget_set_accel_path()</code></a> with the appropriate accelerator group for
the menu item.
</p>
<p>
Note that you do need to set an accelerator on the parent menu with
<a class="link" href="GtkMenu.html#gtk-menu-set-accel-group"><code class="function">gtk_menu_set_accel_group()</code></a> for this to work.</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_item</code></em>&#160;:</span></p></td>
<td>  a valid <a class="link" href="GtkMenuItem.html" title="GtkMenuItem"><span class="type">GtkMenuItem</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>accel_path</code></em>&#160;:</span></p></td>
<td> accelerator path, corresponding to this menu item's
             functionality, or <a
href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"
><code class="literal">NULL</code></a> to unset the current path.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3898072"></a><h3>
<a name="gtk-menu-item-remove-submenu"></a>gtk_menu_item_remove_submenu ()</h3>
<a class="indexterm" name="id3898088"></a><pre class="programlisting">void                gtk_menu_item_remove_submenu        (<a class="link" href="GtkMenuItem.html" title="GtkMenuItem">GtkMenuItem</a> *menu_item);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_menu_item_remove_submenu</code> has been deprecated since version 2.12 and should not be used in newly-written code. <a class="link" href="GtkMenuItem.html#gtk-menu-item-remove-submenu"><code class="function">gtk_menu_item_remove_submenu()</code></a> is deprecated and
                  should not be used in newly written code. Use
                  <a class="link" href="GtkMenuItem.html#gtk-menu-item-set-submenu"><code class="function">gtk_menu_item_set_submenu()</code></a> instead.</p>
</div>
<p>
Removes the widget's submenu.</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_item</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="GtkMenuItem.html" title="GtkMenuItem"><span class="type">GtkMenuItem</span></a>
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3898183"></a><h3>
<a name="gtk-menu-item-select"></a>gtk_menu_item_select ()</h3>
<a class="indexterm" name="id3898196"></a><pre class="programlisting">void                gtk_menu_item_select                (<a class="link" href="GtkMenuItem.html" title="GtkMenuItem">GtkMenuItem</a> *menu_item);</pre>
<p>
Emits the "select" signal on the given item. Behaves exactly like
<a class="link" href="GtkItem.html#gtk-item-select"><span class="type">gtk_item_select</span></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><em class="parameter"><code>menu_item</code></em>&#160;:</span></p></td>
<td>the menu item


</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3898254"></a><h3>
<a name="gtk-menu-item-deselect"></a>gtk_menu_item_deselect ()</h3>
<a class="indexterm" name="id3898267"></a><pre class="programlisting">void                gtk_menu_item_deselect              (<a class="link" href="GtkMenuItem.html" title="GtkMenuItem">GtkMenuItem</a> *menu_item);</pre>
<p>
Emits the "deselect" signal on the given item. Behaves exactly like
<a class="link" href="GtkItem.html#gtk-item-deselect"><span class="type">gtk_item_deselect</span></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><em class="parameter"><code>menu_item</code></em>&#160;:</span></p></td>
<td>the menu item


</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3898325"></a><h3>
<a name="gtk-menu-item-activate"></a>gtk_menu_item_activate ()</h3>
<a class="indexterm" name="id3898338"></a><pre class="programlisting">void                gtk_menu_item_activate              (<a class="link" href="GtkMenuItem.html" title="GtkMenuItem">GtkMenuItem</a> *menu_item);</pre>
<p>
Emits the "activate" signal on the given item
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><em class="parameter"><code>menu_item</code></em>&#160;:</span></p></td>
<td>the menu item


</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3898385"></a><h3>
<a name="gtk-menu-item-toggle-size-request"></a>gtk_menu_item_toggle_size_request ()</h3>
<a class="indexterm" name="id3898400"></a><pre class="programlisting">void                gtk_menu_item_toggle_size_request   (<a class="link" href="GtkMenuItem.html" title="GtkMenuItem">GtkMenuItem</a> *menu_item,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> *requisition);</pre>
<p>
Emits the "toggle_size_request" signal on the given item.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>menu_item</code></em>&#160;:</span></p></td>
<td>the menu item
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>requisition</code></em>&#160;:</span></p></td>
<td>the requisition to use as signal data.


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3898470"></a><h3>
<a name="gtk-menu-item-toggle-size-allocate"></a>gtk_menu_item_toggle_size_allocate ()</h3>
<a class="indexterm" name="id3898484"></a><pre class="programlisting">void                gtk_menu_item_toggle_size_allocate  (<a class="link" href="GtkMenuItem.html" title="GtkMenuItem">GtkMenuItem</a> *menu_item,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> allocation);</pre>
<p>
Emits the "toggle_size_allocate" signal on the given item.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>menu_item</code></em>&#160;:</span></p></td>
<td>the menu item.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>allocation</code></em>&#160;:</span></p></td>
<td>the allocation to use as signal data.


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3898554"></a><h3>
<a name="gtk-menu-item-right-justify"></a>gtk_menu_item_right_justify()</h3>
<a class="indexterm" name="id3898570"></a><pre class="programlisting">#define gtk_menu_item_right_justify(menu_item) gtk_menu_item_set_right_justified ((menu_item), TRUE)
</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_menu_item_right_justify</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Sets the menu item to be right-justified. Only useful for menu bars.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><em class="parameter"><code>menu_item</code></em>&#160;:</span></p></td>