gtkuimanager.html

最新gtk中文资料集

</td>
</tr>
</tbody>
</table></div>
<p class="since">Since  2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3963404"></a><h3>
<a name="gtk-ui-manager-remove-ui"></a>gtk_ui_manager_remove_ui ()</h3>
<a class="indexterm" name="id3963419"></a><pre class="programlisting">void                gtk_ui_manager_remove_ui            (<a class="link" href="GtkUIManager.html" title="GtkUIManager">GtkUIManager</a> *self,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
>guint</a> merge_id);</pre>
<p>
Unmerges the part of <em class="parameter"><code>self</code></em>s content identified by <em class="parameter"><code>merge_id</code></em>.</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>self</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="GtkUIManager.html" title="GtkUIManager"><span class="type">GtkUIManager</span></a> object
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>merge_id</code></em>&#160;:</span></p></td>
<td> a merge id as returned by <a class="link" href="GtkUIManager.html#gtk-ui-manager-add-ui-from-string"><code class="function">gtk_ui_manager_add_ui_from_string()</code></a>
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since  2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3963531"></a><h3>
<a name="gtk-ui-manager-get-ui"></a>gtk_ui_manager_get_ui ()</h3>
<a class="indexterm" name="id3963547"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a>*              gtk_ui_manager_get_ui               (<a class="link" href="GtkUIManager.html" title="GtkUIManager">GtkUIManager</a> *self);</pre>
<p>
Creates a <a class="link" href="GtkUIManager.html#XML-UI" title="UI Definitions">UI definition</a> of the merged UI.</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>self</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="GtkUIManager.html" title="GtkUIManager"><span class="type">GtkUIManager</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> A newly allocated string containing an XML representation of 
the merged UI.

</td>
</tr>
</tbody>
</table></div>
<p class="since">Since  2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3963630"></a><h3>
<a name="gtk-ui-manager-ensure-update"></a>gtk_ui_manager_ensure_update ()</h3>
<a class="indexterm" name="id3963646"></a><pre class="programlisting">void                gtk_ui_manager_ensure_update        (<a class="link" href="GtkUIManager.html" title="GtkUIManager">GtkUIManager</a> *self);</pre>
<p>
Makes sure that all pending updates to the UI have been completed.
</p>
<p>
This may occasionally be necessary, since <a class="link" href="GtkUIManager.html" title="GtkUIManager"><span class="type">GtkUIManager</span></a> updates the 
UI in an idle function. A typical example where this function is
useful is to enforce that the menubar and toolbar have been added to 
the main window before showing it:
</p>
<div class="informalexample"><pre class="programlisting">
gtk_container_add (GTK_CONTAINER (window), vbox); 
g_signal_connect (merge, "add_widget", 
                  G_CALLBACK (add_widget), vbox);
gtk_ui_manager_add_ui_from_file (merge, "my-menus");
gtk_ui_manager_add_ui_from_file (merge, "my-toolbars");
gtk_ui_manager_ensure_update (merge);  
gtk_widget_show (window);
</pre></div>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><em class="parameter"><code>self</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="GtkUIManager.html" title="GtkUIManager"><span class="type">GtkUIManager</span></a>
</td>
</tr></tbody>
</table></div>
<p class="since">Since  2.4
</p>
</div>
</div>
<div class="refsect1" lang="en">
<a name="id3963742"></a><h2>Property Details</h2>
<div class="refsect2" lang="en">
<a name="id3963753"></a><h3>
<a name="GtkUIManager--add-tearoffs"></a>The <code class="literal">"add-tearoffs"</code> property</h3>
<a class="indexterm" name="id3963769"></a><pre class="programlisting">  "add-tearoffs"             <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>              : Read / Write</pre>
<p>
The "add-tearoffs" property controls whether generated menus 
have tearoff menu items. 
</p>
<p>
Note that this only affects regular menus. Generated popup 
menus never have tearoff menu items.</p>
<p>

</p>
<p>Default value: FALSE</p>
<p>Since  2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3963811"></a><h3>
<a name="GtkUIManager--ui"></a>The <code class="literal">"ui"</code> property</h3>
<a class="indexterm" name="id3963827"></a><pre class="programlisting">  "ui"                       <a
href="/usr/share/gtk-doc/html/gobject/gobject-Standard-Parameter-and-Value-Types.html#gchararray"
>gchararray</a>            : Read</pre>
<p>An XML string describing the merged UI.</p>
<p>Default value: "&lt;ui&gt;\n&lt;/ui&gt;\n"</p>
</div>
</div>
<div class="refsect1" lang="en">
<a name="id3963855"></a><h2>Signal Details</h2>
<div class="refsect2" lang="en">
<a name="id3963865"></a><h3>
<a name="GtkUIManager-actions-changed"></a>The <code class="literal">"actions-changed"</code> signal</h3>
<a class="indexterm" name="id3963882"></a><pre class="programlisting">void                user_function                      (<a class="link" href="GtkUIManager.html" title="GtkUIManager">GtkUIManager</a> *merge,
                                                        <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a>      user_data)      : Run First / No Recursion</pre>
<p>
The "actions-changed" signal is emitted whenever the set of actions
changes.</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>merge</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="GtkUIManager.html" title="GtkUIManager"><span class="type">GtkUIManager</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>user_data</code></em>&#160;:</span></p></td>
<td>user data set when the signal handler was connected.</td>
</tr>
</tbody>
</table></div>
<p>Since  2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3963968"></a><h3>
<a name="GtkUIManager-add-widget"></a>The <code class="literal">"add-widget"</code> signal</h3>
<a class="indexterm" name="id3963984"></a><pre class="programlisting">void                user_function                      (<a class="link" href="GtkUIManager.html" title="GtkUIManager">GtkUIManager</a> *merge,
                                                        <a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a>    *widget,
                                                        <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a>      user_data)      : Run First / No Recursion</pre>
<p>
The add_widget signal is emitted for each generated menubar and toolbar.
It is not emitted for generated popup menus, which can be obtained by 
<a class="link" href="GtkUIManager.html#gtk-ui-manager-get-widget"><code class="function">gtk_ui_manager_get_widget()</code></a>.</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>merge</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="GtkUIManager.html" title="GtkUIManager"><span class="type">GtkUIManager</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>widget</code></em>&#160;:</span></p></td>
<td> the added widget
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>user_data</code></em>&#160;:</span></p></td>
<td>user data set when the signal handler was connected.</td>
</tr>
</tbody>
</table></div>
<p>Since  2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3964103"></a><h3>
<a name="GtkUIManager-connect-proxy"></a>The <code class="literal">"connect-proxy"</code> signal</h3>
<a class="indexterm" name="id3964120"></a><pre class="programlisting">void                user_function                      (<a class="link" href="GtkUIManager.html" title="GtkUIManager">GtkUIManager</a> *uimanager,
                                                        <a class="link" href="GtkAction.html" title="GtkAction">GtkAction</a>    *action,
                                                        <a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a>    *proxy,
                                                        <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a>      user_data)      : Run First / No Recursion</pre>
<p>
The connect_proxy signal is emitted after connecting a proxy to 
an action in the group. 
</p>
<p>
This is intended for simple customizations for which a custom action
class would be too clumsy, e.g. showing tooltips for menuitems in the
statusbar.</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>uimanager</code></em>&#160;:</span></p></td>
<td> the ui manager
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>action</code></em>&#160;:</span></p></td>
<td> the action
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>proxy</code></em>&#160;:</span></p></td>
<td> the proxy
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>user_data</code></em>&#160;:</span></p></td>
<td>user data set when the signal handler was connected.</td>
</tr>
</tbody>
</table></div>
<p>Since  2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3964247"></a><h3>
<a name="GtkUIManager-disconnect-proxy"></a>The <code class="literal">"disconnect-proxy"</code> signal</h3>
<a class="indexterm" name="id3964264"></a><pre class="programlisting">void                user_function                      (<a class="link" href="GtkUIManager.html" title="GtkUIManager">GtkUIManager</a> *uimanager,
                                                        <a class="link" href="GtkAction.html" title="GtkAction">GtkAction</a>    *action,
                                                        <a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a>    *proxy,
                                                        <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a>      user_data)      : Run First / No Recursion</pre>
<p>
The disconnect_proxy signal is emitted after disconnecting a proxy 
from an action in the group.</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>uimanager</code></em>&#160;:</span></p></td>
<td> the ui manager
</td>
</tr>
<tr>
<td><p><span c