gtk_stock_add ()

void
gtk_stock_add (const GtkStockItem *items,
               guint n_items);

Registers each of the stock items in items . If an item already exists with the same stock ID as one of the items , the old item gets replaced. The stock items are copied, so GTK+ does not hold any pointer into items and items can be freed. Use gtk_stock_add_static() if items is persistent and GTK+ need not copy the array.

gtk_stock_add_static ()

void
gtk_stock_add_static (const GtkStockItem *items,
                      guint n_items);

Same as gtk_stock_add(), but doesn’t copy items , so items must persist until application exit.

gtk_stock_item_copy ()

GtkStockItem *
gtk_stock_item_copy (const GtkStockItem *item);

Copies a stock item, mostly useful for language bindings and not in applications.

[skip]

gtk_stock_item_free ()

void
gtk_stock_item_free (GtkStockItem *item);

Frees a stock item allocated on the heap, such as one returned by gtk_stock_item_copy(). Also frees the fields inside the stock item, if they are not NULL.

gtk_stock_list_ids ()

GSList *
gtk_stock_list_ids (void);

Retrieves a list of all known stock IDs added to a GtkIconFactory or registered with gtk_stock_add(). The list must be freed with g_slist_free(), and each string in the list must be freed with g_free().

gtk_stock_lookup ()

gboolean
gtk_stock_lookup (const gchar *stock_id,
                  GtkStockItem *item);

Fills item with the registered values for stock_id , returning TRUE if stock_id was known.

gtk_stock_set_translate_func ()

void
gtk_stock_set_translate_func (const gchar *domain,
                              GtkTranslateFunc func,
                              gpointer data,
                              GDestroyNotify notify);

Sets a function to be used for translating the label of a stock item.

If no function is registered for a translation domain, g_dgettext() is used.

The function is used for all stock items whose translation_domain matches domain . Note that it is possible to use strings different from the actual gettext translation domain of your application for this, as long as your GtkTranslateFunc uses the correct domain when calling dgettext(). This can be useful, e.g. when dealing with message contexts:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19

GtkStockItem items[] = { 
 { MY_ITEM1, NC_("odd items", "Item 1"), 0, 0, "odd-item-domain" },
 { MY_ITEM2, NC_("even items", "Item 2"), 0, 0, "even-item-domain" },
};

gchar *
my_translate_func (const gchar *msgid,
                   gpointer     data)
{
  gchar *msgctxt = data;

  return (gchar*)g_dpgettext2 (GETTEXT_PACKAGE, msgctxt, msgid);
}

...

gtk_stock_add (items, G_N_ELEMENTS (items));
gtk_stock_set_translate_func ("odd-item-domain", my_translate_func, "odd items"); 
gtk_stock_set_translate_func ("even-item-domain", my_translate_func, "even items");

Since: 2.8