gtkuimanager.html

最新gtk中文资料集

href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *buffer,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gssize"
>gssize</a> length,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"
>GError</a> **error);</pre>
<p>
Parses a string containing a <a class="link" href="GtkUIManager.html#XML-UI" title="UI Definitions">UI definition</a> and 
merges it with the current contents of <em class="parameter"><code>self</code></em>. An enclosing &lt;ui&gt; 
element is added if it is missing.</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>buffer</code></em>&#160;:</span></p></td>
<td> the string to parse
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>length</code></em>&#160;:</span></p></td>
<td> the length of <em class="parameter"><code>buffer</code></em> (may be -1 if <em class="parameter"><code>buffer</code></em> is nul-terminated)
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></p></td>
<td> return location for an error
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> The merge id for the merged UI. The merge id can be used
  to unmerge the UI with <a class="link" href="GtkUIManager.html#gtk-ui-manager-remove-ui"><code class="function">gtk_ui_manager_remove_ui()</code></a>. If an error occurred,
  the return value is 0.

</td>
</tr>
</tbody>
</table></div>
<p class="since">Since  2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3962539"></a><h3>
<a name="gtk-ui-manager-add-ui-from-file"></a>gtk_ui_manager_add_ui_from_file ()</h3>
<a class="indexterm" name="id3962555"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
>guint</a>               gtk_ui_manager_add_ui_from_file     (<a class="link" href="GtkUIManager.html" title="GtkUIManager">GtkUIManager</a> *self,
                                                         const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *filename,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"
>GError</a> **error);</pre>
<p>
Parses a file containing a <a class="link" href="GtkUIManager.html#XML-UI" title="UI Definitions">UI definition</a> and 
merges it with the current contents of <em class="parameter"><code>self</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>filename</code></em>&#160;:</span></p></td>
<td> the name of the file to parse 
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></p></td>
<td> return location for an error
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> The merge id for the merged UI. The merge id can be used
  to unmerge the UI with <a class="link" href="GtkUIManager.html#gtk-ui-manager-remove-ui"><code class="function">gtk_ui_manager_remove_ui()</code></a>. If an error occurred,
  the return value is 0.

</td>
</tr>
</tbody>
</table></div>
<p class="since">Since  2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3962702"></a><h3>
<a name="gtk-ui-manager-new-merge-id"></a>gtk_ui_manager_new_merge_id ()</h3>
<a class="indexterm" name="id3962718"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
>guint</a>               gtk_ui_manager_new_merge_id         (<a class="link" href="GtkUIManager.html" title="GtkUIManager">GtkUIManager</a> *self);</pre>
<p>
Returns an unused merge id, suitable for use with 
<a class="link" href="GtkUIManager.html#gtk-ui-manager-add-ui"><code class="function">gtk_ui_manager_add_ui()</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>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> an unused merge id.

</td>
</tr>
</tbody>
</table></div>
<p class="since">Since  2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3962805"></a><h3>
<a name="GtkUIManagerItemType"></a>enum GtkUIManagerItemType</h3>
<a class="indexterm" name="id3962818"></a><pre class="programlisting">typedef enum {
  GTK_UI_MANAGER_AUTO         = 0,
  GTK_UI_MANAGER_MENUBAR      = 1 &lt;&lt; 0,
  GTK_UI_MANAGER_MENU         = 1 &lt;&lt; 1,
  GTK_UI_MANAGER_TOOLBAR      = 1 &lt;&lt; 2,
  GTK_UI_MANAGER_PLACEHOLDER  = 1 &lt;&lt; 3,
  GTK_UI_MANAGER_POPUP        = 1 &lt;&lt; 4,
  GTK_UI_MANAGER_MENUITEM     = 1 &lt;&lt; 5,
  GTK_UI_MANAGER_TOOLITEM     = 1 &lt;&lt; 6,
  GTK_UI_MANAGER_SEPARATOR    = 1 &lt;&lt; 7,
  GTK_UI_MANAGER_ACCELERATOR  = 1 &lt;&lt; 8
} GtkUIManagerItemType;
</pre>
<p>
These enumeration values are used by <a class="link" href="GtkUIManager.html#gtk-ui-manager-add-ui"><code class="function">gtk_ui_manager_add_ui()</code></a> to determine
what UI element to create.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><a name="GTK-UI-MANAGER-AUTO:CAPS"></a><code class="literal">GTK_UI_MANAGER_AUTO</code></span></p></td>
<td>Pick the type of the UI element according to context.
</td>
</tr>
<tr>
<td><p><span class="term"><a name="GTK-UI-MANAGER-MENUBAR:CAPS"></a><code class="literal">GTK_UI_MANAGER_MENUBAR</code></span></p></td>
<td>Create a menubar.
</td>
</tr>
<tr>
<td><p><span class="term"><a name="GTK-UI-MANAGER-MENU:CAPS"></a><code class="literal">GTK_UI_MANAGER_MENU</code></span></p></td>
<td>Create a menu.
</td>
</tr>
<tr>
<td><p><span class="term"><a name="GTK-UI-MANAGER-TOOLBAR:CAPS"></a><code class="literal">GTK_UI_MANAGER_TOOLBAR</code></span></p></td>
<td>Create a toolbar.
</td>
</tr>
<tr>
<td><p><span class="term"><a name="GTK-UI-MANAGER-PLACEHOLDER:CAPS"></a><code class="literal">GTK_UI_MANAGER_PLACEHOLDER</code></span></p></td>
<td>Insert a placeholder.
</td>
</tr>
<tr>
<td><p><span class="term"><a name="GTK-UI-MANAGER-POPUP:CAPS"></a><code class="literal">GTK_UI_MANAGER_POPUP</code></span></p></td>
<td>Create a popup menu.
</td>
</tr>
<tr>
<td><p><span class="term"><a name="GTK-UI-MANAGER-MENUITEM:CAPS"></a><code class="literal">GTK_UI_MANAGER_MENUITEM</code></span></p></td>
<td>Create a menuitem.
</td>
</tr>
<tr>
<td><p><span class="term"><a name="GTK-UI-MANAGER-TOOLITEM:CAPS"></a><code class="literal">GTK_UI_MANAGER_TOOLITEM</code></span></p></td>
<td>Create a toolitem.
</td>
</tr>
<tr>
<td><p><span class="term"><a name="GTK-UI-MANAGER-SEPARATOR:CAPS"></a><code class="literal">GTK_UI_MANAGER_SEPARATOR</code></span></p></td>
<td>Create a separator.
</td>
</tr>
<tr>
<td><p><span class="term"><a name="GTK-UI-MANAGER-ACCELERATOR:CAPS"></a><code class="literal">GTK_UI_MANAGER_ACCELERATOR</code></span></p></td>
<td>Install an accelerator.

</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3963093"></a><h3>
<a name="gtk-ui-manager-add-ui"></a>gtk_ui_manager_add_ui ()</h3>
<a class="indexterm" name="id3963109"></a><pre class="programlisting">void                gtk_ui_manager_add_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,
                                                         const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *path,
                                                         const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *name,
                                                         const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *action,
                                                         <a class="link" href="GtkUIManager.html#GtkUIManagerItemType">GtkUIManagerItemType</a> type,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> top);</pre>
<p>
Adds a UI element to the current contents of <em class="parameter"><code>self</code></em>. 
</p>
<p>
If <em class="parameter"><code>type</code></em> is <a class="link" href="GtkUIManager.html#GTK-UI-MANAGER-AUTO:CAPS"><code class="literal">GTK_UI_MANAGER_AUTO</code></a>, GTK+ inserts a menuitem, toolitem or 
separator if such an element can be inserted at the place determined by 
<em class="parameter"><code>path</code></em>. Otherwise <em class="parameter"><code>type</code></em> must indicate an element that can be inserted at 
the place determined by <em class="parameter"><code>path</code></em>.
</p>
<p>
If <em class="parameter"><code>path</code></em> points to a menuitem or toolitem, the new element will be inserted
before or after this item, depending on <em class="parameter"><code>top</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>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>merge_id</code></em>&#160;:</span></p></td>
<td> the merge id for the merged UI, see <a class="link" href="GtkUIManager.html#gtk-ui-manager-new-merge-id"><code class="function">gtk_ui_manager_new_merge_id()</code></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>path</code></em>&#160;:</span></p></td>
<td> a path
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>name</code></em>&#160;:</span></p></td>
<td> the name for the added UI element
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>action</code></em>&#160;:</span></p></td>
<td> the name of the action to be proxied, or <a
href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"
><code class="literal">NULL</code></a> to add a separator
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>type</code></em>&#160;:</span></p></td>
<td> the type of UI element to add.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>top</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 UI element is added before its siblings, otherwise it 
  is added after its siblings.