43
43
<a class="link" href="gtk-Stock-Items.html#GtkStockItem" title="GtkStockItem">GtkStockItem</a>;
44
44
<span class="returnvalue">void</span> <a class="link" href="gtk-Stock-Items.html#gtk-stock-add" title="gtk_stock_add ()">gtk_stock_add</a> (<em class="parameter"><code>const <a class="link" href="gtk-Stock-Items.html#GtkStockItem" title="GtkStockItem"><span class="type">GtkStockItem</span></a> *items</code></em>,
45
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> n_items</code></em>);
45
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> n_items</code></em>);
46
46
<span class="returnvalue">void</span> <a class="link" href="gtk-Stock-Items.html#gtk-stock-add-static" title="gtk_stock_add_static ()">gtk_stock_add_static</a> (<em class="parameter"><code>const <a class="link" href="gtk-Stock-Items.html#GtkStockItem" title="GtkStockItem"><span class="type">GtkStockItem</span></a> *items</code></em>,
47
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> n_items</code></em>);
47
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> n_items</code></em>);
48
48
<a class="link" href="gtk-Stock-Items.html#GtkStockItem" title="GtkStockItem"><span class="returnvalue">GtkStockItem</span></a> * <a class="link" href="gtk-Stock-Items.html#gtk-stock-item-copy" title="gtk_stock_item_copy ()">gtk_stock_item_copy</a> (<em class="parameter"><code>const <a class="link" href="gtk-Stock-Items.html#GtkStockItem" title="GtkStockItem"><span class="type">GtkStockItem</span></a> *item</code></em>);
49
49
<span class="returnvalue">void</span> <a class="link" href="gtk-Stock-Items.html#gtk-stock-item-free" title="gtk_stock_item_free ()">gtk_stock_item_free</a> (<em class="parameter"><code><a class="link" href="gtk-Stock-Items.html#GtkStockItem" title="GtkStockItem"><span class="type">GtkStockItem</span></a> *item</code></em>);
50
<a href="/usr/share/gtk-doc/html/glib/glib-Singly-Linked-Lists.html#GSList"><span class="returnvalue">GSList</span></a>* <a class="link" href="gtk-Stock-Items.html#gtk-stock-list-ids" title="gtk_stock_list_ids ()">gtk_stock_list_ids</a> (<em class="parameter"><code><span class="type">void</span></code></em>);
51
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="gtk-Stock-Items.html#gtk-stock-lookup" title="gtk_stock_lookup ()">gtk_stock_lookup</a> (<em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *stock_id</code></em>,
50
<a href="http://library.gnome.org/devel/glib/unstable/glib-Singly-Linked-Lists.html#GSList"><span class="returnvalue">GSList</span></a>* <a class="link" href="gtk-Stock-Items.html#gtk-stock-list-ids" title="gtk_stock_list_ids ()">gtk_stock_list_ids</a> (<em class="parameter"><code><span class="type">void</span></code></em>);
51
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="gtk-Stock-Items.html#gtk-stock-lookup" title="gtk_stock_lookup ()">gtk_stock_lookup</a> (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *stock_id</code></em>,
52
52
<em class="parameter"><code><a class="link" href="gtk-Stock-Items.html#GtkStockItem" title="GtkStockItem"><span class="type">GtkStockItem</span></a> *item</code></em>);
53
<span class="returnvalue">void</span> <a class="link" href="gtk-Stock-Items.html#gtk-stock-set-translate-func" title="gtk_stock_set_translate_func ()">gtk_stock_set_translate_func</a> (<em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *domain</code></em>,
53
<span class="returnvalue">void</span> <a class="link" href="gtk-Stock-Items.html#gtk-stock-set-translate-func" title="gtk_stock_set_translate_func ()">gtk_stock_set_translate_func</a> (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *domain</code></em>,
54
54
<em class="parameter"><code><a class="link" href="GtkItemFactory.html#GtkTranslateFunc" title="GtkTranslateFunc ()"><span class="type">GtkTranslateFunc</span></a> func</code></em>,
55
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>,
56
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> notify</code></em>);
55
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>,
56
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> notify</code></em>);
58
58
#define <a class="link" href="gtk-Stock-Items.html#GTK-STOCK-ABOUT:CAPS" title="GTK_STOCK_ABOUT">GTK_STOCK_ABOUT</a>
59
59
#define <a class="link" href="gtk-Stock-Items.html#GTK-STOCK-ADD:CAPS" title="GTK_STOCK_ADD">GTK_STOCK_ADD</a>
203
203
<div class="refsect2" title="gtk_stock_add ()">
204
204
<a name="gtk-stock-add"></a><h3>gtk_stock_add ()</h3>
205
205
<pre class="programlisting"><span class="returnvalue">void</span> gtk_stock_add (<em class="parameter"><code>const <a class="link" href="gtk-Stock-Items.html#GtkStockItem" title="GtkStockItem"><span class="type">GtkStockItem</span></a> *items</code></em>,
206
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> n_items</code></em>);</pre>
206
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> n_items</code></em>);</pre>
208
208
Registers each of the stock items in <em class="parameter"><code>items</code></em>. If an item already
209
209
exists with the same stock ID as one of the <em class="parameter"><code>items</code></em>, the old item
232
232
<div class="refsect2" title="gtk_stock_add_static ()">
233
233
<a name="gtk-stock-add-static"></a><h3>gtk_stock_add_static ()</h3>
234
234
<pre class="programlisting"><span class="returnvalue">void</span> gtk_stock_add_static (<em class="parameter"><code>const <a class="link" href="gtk-Stock-Items.html#GtkStockItem" title="GtkStockItem"><span class="type">GtkStockItem</span></a> *items</code></em>,
235
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> n_items</code></em>);</pre>
235
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> n_items</code></em>);</pre>
237
237
Same as <a class="link" href="gtk-Stock-Items.html#gtk-stock-add" title="gtk_stock_add ()"><code class="function">gtk_stock_add()</code></a>, but doesn't copy <em class="parameter"><code>items</code></em>, so
238
238
<em class="parameter"><code>items</code></em> must persist until application exit.
284
284
Frees a stock item allocated on the heap, such as one returned by
285
285
<a class="link" href="gtk-Stock-Items.html#gtk-stock-item-copy" title="gtk_stock_item_copy ()"><code class="function">gtk_stock_item_copy()</code></a>. Also frees the fields inside the stock item,
286
if they are not <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.
286
if they are not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.
288
288
<div class="variablelist"><table border="0">
289
289
<col align="left" valign="top">
298
298
<div class="refsect2" title="gtk_stock_list_ids ()">
299
299
<a name="gtk-stock-list-ids"></a><h3>gtk_stock_list_ids ()</h3>
300
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Singly-Linked-Lists.html#GSList"><span class="returnvalue">GSList</span></a>* gtk_stock_list_ids (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
300
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Singly-Linked-Lists.html#GSList"><span class="returnvalue">GSList</span></a>* gtk_stock_list_ids (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
302
302
Retrieves a list of all known stock IDs added to a <a class="link" href="gtk-Themeable-Stock-Images.html#GtkIconFactory"><span class="type">GtkIconFactory</span></a>
303
or registered with <a class="link" href="gtk-Stock-Items.html#gtk-stock-add" title="gtk_stock_add ()"><code class="function">gtk_stock_add()</code></a>. The list must be freed with <a href="/usr/share/gtk-doc/html/glib/glib-Singly-Linked-Lists.html#g-slist-free"><code class="function">g_slist_free()</code></a>,
304
and each string in the list must be freed with <a href="/usr/share/gtk-doc/html/glib/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>.
303
or registered with <a class="link" href="gtk-Stock-Items.html#gtk-stock-add" title="gtk_stock_add ()"><code class="function">gtk_stock_add()</code></a>. The list must be freed with <a href="http://library.gnome.org/devel/glib/unstable/glib-Singly-Linked-Lists.html#g-slist-free"><code class="function">g_slist_free()</code></a>,
304
and each string in the list must be freed with <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>.
306
306
<div class="variablelist"><table border="0">
307
307
<col align="left" valign="top">
316
316
<div class="refsect2" title="gtk_stock_lookup ()">
317
317
<a name="gtk-stock-lookup"></a><h3>gtk_stock_lookup ()</h3>
318
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> gtk_stock_lookup (<em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *stock_id</code></em>,
318
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> gtk_stock_lookup (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *stock_id</code></em>,
319
319
<em class="parameter"><code><a class="link" href="gtk-Stock-Items.html#GtkStockItem" title="GtkStockItem"><span class="type">GtkStockItem</span></a> *item</code></em>);</pre>
321
Fills <em class="parameter"><code>item</code></em> with the registered values for <em class="parameter"><code>stock_id</code></em>, returning <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>
321
Fills <em class="parameter"><code>item</code></em> with the registered values for <em class="parameter"><code>stock_id</code></em>, returning <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>
322
322
if <em class="parameter"><code>stock_id</code></em> was known.
324
324
<div class="variablelist"><table border="0">
346
346
<div class="refsect2" title="gtk_stock_set_translate_func ()">
347
347
<a name="gtk-stock-set-translate-func"></a><h3>gtk_stock_set_translate_func ()</h3>
348
<pre class="programlisting"><span class="returnvalue">void</span> gtk_stock_set_translate_func (<em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *domain</code></em>,
348
<pre class="programlisting"><span class="returnvalue">void</span> gtk_stock_set_translate_func (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *domain</code></em>,
349
349
<em class="parameter"><code><a class="link" href="GtkItemFactory.html#GtkTranslateFunc" title="GtkTranslateFunc ()"><span class="type">GtkTranslateFunc</span></a> func</code></em>,
350
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>,
351
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> notify</code></em>);</pre>
350
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>,
351
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> notify</code></em>);</pre>
353
353
Sets a function to be used for translating the <em class="parameter"><code>label</code></em> of
357
357
If no function is registered for a translation domain,
358
<a href="/usr/share/gtk-doc/html/glib/glib-I18N.html#g-dgettext"><code class="function">g_dgettext()</code></a> is used.
358
<a href="http://library.gnome.org/devel/glib/unstable/glib-I18N.html#g-dgettext"><code class="function">g_dgettext()</code></a> is used.
361
361
The function is used for all stock items whose
393
<td class="listing_code"><pre class="programlisting"><span class="normal"><a href="gtk-Stock-Items.html#GtkStockItem">GtkStockItem</a> items</span><span class="symbol">[]</span><span class="normal"> </span><span class="symbol">=</span><span class="normal"> </span><span class="cbracket">{</span><span class="normal"> </span>
394
<span class="normal"> </span><span class="cbracket">{</span><span class="normal"> MY_ITEM1</span><span class="symbol">,</span><span class="normal"> </span><span class="function"><a href="/usr/share/gtk-doc/html/glib/glib-I18N.html#NC-:CAPS">NC_</a></span><span class="symbol">(</span><span class="string">"odd items"</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"Item 1"</span><span class="symbol">),</span><span class="normal"> </span><span class="number">0</span><span class="symbol">,</span><span class="normal"> </span><span class="number">0</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"odd-item-domain"</span><span class="normal"> </span><span class="cbracket">}</span><span class="symbol">,</span>
395
<span class="normal"> </span><span class="cbracket">{</span><span class="normal"> MY_ITEM2</span><span class="symbol">,</span><span class="normal"> </span><span class="function"><a href="/usr/share/gtk-doc/html/glib/glib-I18N.html#NC-:CAPS">NC_</a></span><span class="symbol">(</span><span class="string">"even items"</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"Item 2"</span><span class="symbol">),</span><span class="normal"> </span><span class="number">0</span><span class="symbol">,</span><span class="normal"> </span><span class="number">0</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"even-item-domain"</span><span class="normal"> </span><span class="cbracket">}</span><span class="symbol">,</span>
393
<td class="listing_code"><pre class="programlisting"><span class="usertype">GtkStockItem</span><span class="normal"> items</span><span class="symbol">[]</span><span class="normal"> </span><span class="symbol">=</span><span class="normal"> </span><span class="cbracket">{</span><span class="normal"> </span>
394
<span class="normal"> </span><span class="cbracket">{</span><span class="normal"> MY_ITEM1</span><span class="symbol">,</span><span class="normal"> </span><span class="function"><a href="http://library.gnome.org/devel/glib/unstable/glib-I18N.html#NC-:CAPS">NC_</a></span><span class="symbol">(</span><span class="string">"odd items"</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"Item 1"</span><span class="symbol">),</span><span class="normal"> </span><span class="number">0</span><span class="symbol">,</span><span class="normal"> </span><span class="number">0</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"odd-item-domain"</span><span class="normal"> </span><span class="cbracket">}</span><span class="symbol">,</span>
395
<span class="normal"> </span><span class="cbracket">{</span><span class="normal"> MY_ITEM2</span><span class="symbol">,</span><span class="normal"> </span><span class="function"><a href="http://library.gnome.org/devel/glib/unstable/glib-I18N.html#NC-:CAPS">NC_</a></span><span class="symbol">(</span><span class="string">"even items"</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"Item 2"</span><span class="symbol">),</span><span class="normal"> </span><span class="number">0</span><span class="symbol">,</span><span class="normal"> </span><span class="number">0</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"even-item-domain"</span><span class="normal"> </span><span class="cbracket">}</span><span class="symbol">,</span>
396
396
<span class="cbracket">}</span><span class="symbol">;</span>
398
<span class="normal"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> </span><span class="symbol">*</span>
399
<span class="function">my_translate_func</span><span class="normal"> </span><span class="symbol">(</span><span class="keyword">const</span><span class="normal"> <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> </span><span class="symbol">*</span><span class="normal">msgid</span><span class="symbol">,</span>
400
<span class="normal"> <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer">gpointer</a> data</span><span class="symbol">)</span>
398
<span class="normal"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> </span><span class="symbol">*</span>
399
<span class="function">my_translate_func</span><span class="normal"> </span><span class="symbol">(</span><span class="keyword">const</span><span class="normal"> </span><span class="usertype">gchar</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">msgid</span><span class="symbol">,</span>
400
<span class="normal"> </span><span class="usertype">gpointer</span><span class="normal"> data</span><span class="symbol">)</span>
401
401
<span class="cbracket">{</span>
402
<span class="normal"> <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> </span><span class="symbol">*</span><span class="normal">msgctxt </span><span class="symbol">=</span><span class="normal"> data</span><span class="symbol">;</span>
402
<span class="normal"> </span><span class="usertype">gchar</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">msgctxt </span><span class="symbol">=</span><span class="normal"> data</span><span class="symbol">;</span>
404
<span class="normal"> </span><span class="keyword">return</span><span class="normal"> </span><span class="symbol">(</span><span class="normal"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a></span><span class="symbol">*)</span><span class="function"><a href="/usr/share/gtk-doc/html/glib/glib-I18N.html#g-dpgettext2">g_dpgettext2</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">GETTEXT_PACKAGE</span><span class="symbol">,</span><span class="normal"> msgctxt</span><span class="symbol">,</span><span class="normal"> msgid</span><span class="symbol">);</span>
404
<span class="normal"> </span><span class="keyword">return</span><span class="normal"> </span><span class="symbol">(</span><span class="normal"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a></span><span class="symbol">*)</span><span class="function"><a href="http://library.gnome.org/devel/glib/unstable/glib-I18N.html#g-dpgettext2">g_dpgettext2</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">GETTEXT_PACKAGE</span><span class="symbol">,</span><span class="normal"> msgctxt</span><span class="symbol">,</span><span class="normal"> msgid</span><span class="symbol">);</span>
405
405
<span class="cbracket">}</span>
407
407
<span class="comment">/* ... */</span>
409
<span class="function"><a href="gtk-Stock-Items.html#gtk-stock-add">gtk_stock_add</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">items</span><span class="symbol">,</span><span class="normal"> </span><span class="function"><a href="/usr/share/gtk-doc/html/glib/glib-Miscellaneous-Macros.html#G-N-ELEMENTS:CAPS">G_N_ELEMENTS</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">items</span><span class="symbol">));</span>
409
<span class="function"><a href="gtk-Stock-Items.html#gtk-stock-add">gtk_stock_add</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">items</span><span class="symbol">,</span><span class="normal"> </span><span class="function"><a href="http://library.gnome.org/devel/glib/unstable/glib-Miscellaneous-Macros.html#G-N-ELEMENTS:CAPS">G_N_ELEMENTS</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">items</span><span class="symbol">));</span>
410
410
<span class="function"><a href="gtk-Stock-Items.html#gtk-stock-set-translate-func">gtk_stock_set_translate_func</a></span><span class="normal"> </span><span class="symbol">(</span><span class="string">"odd-item-domain"</span><span class="symbol">,</span><span class="normal"> my_translate_func</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"odd items"</span><span class="symbol">);</span><span class="normal"> </span>
411
411
<span class="function"><a href="gtk-Stock-Items.html#gtk-stock-set-translate-func">gtk_stock_set_translate_func</a></span><span class="normal"> </span><span class="symbol">(</span><span class="string">"even-item-domain"</span><span class="symbol">,</span><span class="normal"> my_translate_func</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"even items"</span><span class="symbol">);</span></pre></td>