-/* GTK - The GIMP Toolkit
- * Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald
+/* GTK - The GTK+ Toolkit
+ * Copyright (C) 2000 Red Hat, Inc.
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* GTK+ at ftp://ftp.gtk.org/pub/gtk/.
*/
+#include "config.h"
+#include <string.h>
+
#include "gtkstock.h"
+#include "gtkiconfactory.h"
#include "gtkintl.h"
#include <gdk/gdkkeysyms.h>
+#include "gtkalias.h"
+static GHashTable *translate_hash = NULL;
static GHashTable *stock_hash = NULL;
static void init_stock_hash (void);
+/* We use an unused modifier bit to mark stock items which
+ * must be freed when they are removed from the hash table.
+ */
+#define NON_STATIC_MASK (1 << 29)
+
+typedef struct _GtkStockTranslateFunc GtkStockTranslateFunc;
+struct _GtkStockTranslateFunc
+{
+ GtkTranslateFunc func;
+ gpointer data;
+ GDestroyNotify notify;
+};
+
static void
real_add (const GtkStockItem *items,
guint n_items,
{
gpointer old_key, old_value;
const GtkStockItem *item = &items[i];
+
+ if (item->modifier & NON_STATIC_MASK)
+ {
+ g_warning ("Bit 29 set in stock accelerator.\n");
+ copy = TRUE;
+ }
+
if (copy)
- item = gtk_stock_item_copy (item);
+ {
+ item = gtk_stock_item_copy (item);
+ ((GtkStockItem *)item)->modifier |= NON_STATIC_MASK;
+ }
if (g_hash_table_lookup_extended (stock_hash, item->stock_id,
&old_key, &old_value))
{
g_hash_table_remove (stock_hash, old_key);
- gtk_stock_item_free (old_value);
+ if (((GtkStockItem *)old_value)->modifier & NON_STATIC_MASK)
+ gtk_stock_item_free (old_value);
}
g_hash_table_insert (stock_hash,
}
}
+/**
+ * gtk_stock_add:
+ * @items: a #GtkStockItem or array of items
+ * @n_items: number of #GtkStockItem in @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.
+ *
+ **/
void
gtk_stock_add (const GtkStockItem *items,
guint n_items)
real_add (items, n_items, TRUE);
}
+/**
+ * gtk_stock_add_static:
+ * @items: a #GtkStockItem or array of #GtkStockItem
+ * @n_items: number of items
+ *
+ * Same as gtk_stock_add(), but doesn't copy @items, so
+ * @items must persist until application exit.
+ *
+ **/
void
gtk_stock_add_static (const GtkStockItem *items,
guint n_items)
real_add (items, n_items, FALSE);
}
+/**
+ * gtk_stock_lookup:
+ * @stock_id: a stock item name
+ * @item: stock item to initialize with values
+ *
+ * Fills @item with the registered values for @stock_id, returning %TRUE
+ * if @stock_id was known.
+ *
+ *
+ * Return value: %TRUE if @item was initialized
+ **/
gboolean
gtk_stock_lookup (const gchar *stock_id,
GtkStockItem *item)
if (found)
{
*item = *found;
+ item->modifier &= ~NON_STATIC_MASK;
if (item->label)
- item->label = dgettext (item->translation_domain, item->label);
+ {
+ GtkStockTranslateFunc *translate;
+
+ if (item->translation_domain)
+ translate = (GtkStockTranslateFunc *)
+ g_hash_table_lookup (translate_hash, item->translation_domain);
+ else
+ translate = NULL;
+
+ if (translate != NULL && translate->func != NULL)
+ item->label = (* translate->func) (item->label, translate->data);
+ else
+ item->label = g_dgettext (item->translation_domain, item->label);
+ }
}
return found != NULL;
}
-static void
-listify_foreach (gpointer key, gpointer value, gpointer data)
+/**
+ * gtk_stock_list_ids:
+ *
+ * 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().
+ *
+ * Return value: a list of known stock IDs
+ **/
+GSList*
+gtk_stock_list_ids (void)
{
- GSList **list = data;
+ GList *ids;
+ GList *icon_ids;
+ GSList *retval;
+ const gchar *last_id;
+
+ init_stock_hash ();
- *list = g_slist_prepend (*list, value);
-}
+ ids = g_hash_table_get_keys (stock_hash);
+ icon_ids = _gtk_icon_factory_list_ids ();
+ ids = g_list_concat (ids, icon_ids);
-static GSList *
-g_hash_table_get_values (GHashTable *table)
-{
- GSList *list = NULL;
+ ids = g_list_sort (ids, (GCompareFunc)strcmp);
- g_hash_table_foreach (table, listify_foreach, &list);
+ last_id = NULL;
+ retval = NULL;
+ while (ids != NULL)
+ {
+ GList *next;
- return list;
-}
+ next = g_list_next (ids);
-GSList *
-gtk_stock_list_items (void)
-{
- init_stock_hash ();
+ if (last_id && strcmp (ids->data, last_id) == 0)
+ {
+ /* duplicate, ignore */
+ }
+ else
+ {
+ retval = g_slist_prepend (retval, g_strdup (ids->data));
+ last_id = ids->data;
+ }
+
+ g_list_free_1 (ids);
+
+ ids = next;
+ }
- return g_hash_table_get_values (stock_hash);
+ return retval;
}
+/**
+ * gtk_stock_item_copy:
+ * @item: a #GtkStockItem
+ *
+ * Copies a stock item, mostly useful for language bindings and not in applications.
+ *
+ * Return value: a new #GtkStockItem
+ **/
GtkStockItem *
gtk_stock_item_copy (const GtkStockItem *item)
{
return copy;
}
+/**
+ * gtk_stock_item_free:
+ * @item: a #GtkStockItem
+ *
+ * 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.
+ *
+ **/
void
gtk_stock_item_free (GtkStockItem *item)
{
g_free (item);
}
-static GtkStockItem builtin_items [] =
+static const GtkStockItem builtin_items [] =
{
- /* KEEP IN SYNC with gtkiconfactory.c stock icons */
+ /* KEEP IN SYNC with gtkiconfactory.c stock icons, when appropriate */
{ GTK_STOCK_DIALOG_INFO, N_("Information"), 0, 0, GETTEXT_PACKAGE },
{ GTK_STOCK_DIALOG_WARNING, N_("Warning"), 0, 0, GETTEXT_PACKAGE },
{ GTK_STOCK_DIALOG_ERROR, N_("Error"), 0, 0, GETTEXT_PACKAGE },
{ GTK_STOCK_DIALOG_QUESTION, N_("Question"), 0, 0, GETTEXT_PACKAGE },
- { GTK_STOCK_BUTTON_APPLY, N_("_Apply"), 0, 0, GETTEXT_PACKAGE },
- { GTK_STOCK_BUTTON_OK, N_("OK"), 0, 0, GETTEXT_PACKAGE },
- { GTK_STOCK_BUTTON_CANCEL, N_("Cancel"), 0, 0, GETTEXT_PACKAGE },
- { GTK_STOCK_BUTTON_CLOSE, N_("_Close"), 0, 0, GETTEXT_PACKAGE },
- { GTK_STOCK_BUTTON_YES, N_("_Yes"), 0, 0, GETTEXT_PACKAGE },
- { GTK_STOCK_BUTTON_NO, N_("_No"), 0, 0, GETTEXT_PACKAGE },
-
- { GTK_STOCK_CLOSE, N_("Close"), GDK_CONTROL_MASK, 'w', GETTEXT_PACKAGE },
- { GTK_STOCK_QUIT, N_("Quit"), GDK_CONTROL_MASK, 'q', GETTEXT_PACKAGE },
- { GTK_STOCK_HELP, N_("Help"), GDK_CONTROL_MASK, 'h', GETTEXT_PACKAGE },
- { GTK_STOCK_NEW, N_("New"), GDK_CONTROL_MASK, 'n', GETTEXT_PACKAGE },
- { GTK_STOCK_OPEN, N_("Open"), GDK_CONTROL_MASK, 'o', GETTEXT_PACKAGE },
- { GTK_STOCK_SAVE, N_("Save"), GDK_CONTROL_MASK, 's', GETTEXT_PACKAGE }
+ /* FIXME these need accelerators when appropriate, and
+ * need the mnemonics to be rationalized
+ */
+ { GTK_STOCK_ABOUT, N_("_About"), 0, 0, GETTEXT_PACKAGE },
+ { GTK_STOCK_ADD, N_("_Add"), 0, 0, GETTEXT_PACKAGE },
+ { GTK_STOCK_APPLY, N_("_Apply"), 0, 0, GETTEXT_PACKAGE },
+ { GTK_STOCK_BOLD, N_("_Bold"), 0, 0, GETTEXT_PACKAGE },
+ { GTK_STOCK_CANCEL, N_("_Cancel"), 0, 0, GETTEXT_PACKAGE },
+ { GTK_STOCK_CDROM, N_("_CD-Rom"), 0, 0, GETTEXT_PACKAGE },
+ { GTK_STOCK_CLEAR, N_("_Clear"), 0, 0, GETTEXT_PACKAGE },
+ { GTK_STOCK_CLOSE, N_("_Close"), GDK_CONTROL_MASK, 'w', GETTEXT_PACKAGE },
+ { GTK_STOCK_CONNECT, N_("C_onnect"), 0, 0, GETTEXT_PACKAGE },
+ { GTK_STOCK_CONVERT, N_("_Convert"), 0, 0, GETTEXT_PACKAGE },
+ { GTK_STOCK_COPY, N_("_Copy"), GDK_CONTROL_MASK, 'c', GETTEXT_PACKAGE },
+ { GTK_STOCK_CUT, N_("Cu_t"), GDK_CONTROL_MASK, 'x', GETTEXT_PACKAGE },
+ { GTK_STOCK_DELETE, N_("_Delete"), 0, 0, GETTEXT_PACKAGE },
+ { GTK_STOCK_DISCARD, N_("_Discard"), 0, 0, GETTEXT_PACKAGE },
+ { GTK_STOCK_DISCONNECT, N_("_Disconnect"), 0, 0, GETTEXT_PACKAGE },
+ { GTK_STOCK_EXECUTE, N_("_Execute"), 0, 0, GETTEXT_PACKAGE },
+ { GTK_STOCK_EDIT, N_("_Edit"), 0, 0, GETTEXT_PACKAGE },
+ { GTK_STOCK_FIND, N_("_Find"), GDK_CONTROL_MASK, 'f', GETTEXT_PACKAGE },
+ { GTK_STOCK_FIND_AND_REPLACE, N_("Find and _Replace"), GDK_CONTROL_MASK, 'r', GETTEXT_PACKAGE },
+ { GTK_STOCK_FLOPPY, N_("_Floppy"), 0, 0, GETTEXT_PACKAGE },
+ { GTK_STOCK_FULLSCREEN, N_("_Fullscreen"), 0, 0, GETTEXT_PACKAGE },
+ { GTK_STOCK_LEAVE_FULLSCREEN, N_("_Leave Fullscreen"), 0, 0, GETTEXT_PACKAGE },
+ /* translators, strip the prefix up to and including the first | */
+ { GTK_STOCK_GOTO_BOTTOM, N_("Navigation|_Bottom"), 0, 0, GETTEXT_PACKAGE },
+ /* translators, strip the prefix up to and including the first | */
+ { GTK_STOCK_GOTO_FIRST, N_("Navigation|_First"), 0, 0, GETTEXT_PACKAGE },
+ /* translators, strip the prefix up to and including the first | */
+ { GTK_STOCK_GOTO_LAST, N_("Navigation|_Last"), 0, 0, GETTEXT_PACKAGE },
+ /* translators, strip the prefix up to and including the first | */
+ { GTK_STOCK_GOTO_TOP, N_("Navigation|_Top"), 0, 0, GETTEXT_PACKAGE },
+ /* translators, strip the prefix up to and including the first | */
+ { GTK_STOCK_GO_BACK, N_("Navigation|_Back"), 0, 0, GETTEXT_PACKAGE },
+ /* translators, strip the prefix up to and including the first | */
+ { GTK_STOCK_GO_DOWN, N_("Navigation|_Down"), 0, 0, GETTEXT_PACKAGE },
+ /* translators, strip the prefix up to and including the first | */
+ { GTK_STOCK_GO_FORWARD, N_("Navigation|_Forward"), 0, 0, GETTEXT_PACKAGE },
+ /* translators, strip the prefix up to and including the first | */
+ { GTK_STOCK_GO_UP, N_("Navigation|_Up"), 0, 0, GETTEXT_PACKAGE },
+ { GTK_STOCK_HARDDISK, N_("_Harddisk"), 0, 0, GETTEXT_PACKAGE },
+ { GTK_STOCK_HELP, N_("_Help"), GDK_CONTROL_MASK, 'h', GETTEXT_PACKAGE },
+ { GTK_STOCK_HOME, N_("_Home"), 0, 0, GETTEXT_PACKAGE },
+ { GTK_STOCK_INDENT, N_("Increase Indent"), 0, 0, GETTEXT_PACKAGE },
+ { GTK_STOCK_UNINDENT, N_("Decrease Indent"), 0, 0, GETTEXT_PACKAGE },
+ { GTK_STOCK_INDEX, N_("_Index"), 0, 0, GETTEXT_PACKAGE },
+ { GTK_STOCK_INFO, N_("_Information"), 0, 0, GETTEXT_PACKAGE },
+ { GTK_STOCK_ITALIC, N_("_Italic"), 0, 0, GETTEXT_PACKAGE },
+ { GTK_STOCK_JUMP_TO, N_("_Jump to"), 0, 0, GETTEXT_PACKAGE },
+ /* translators, strip the prefix up to and including the first | */
+ { GTK_STOCK_JUSTIFY_CENTER, N_("Justify|_Center"), 0, 0, GETTEXT_PACKAGE },
+ /* translators, strip the prefix up to and including the first | */
+ { GTK_STOCK_JUSTIFY_FILL, N_("Justify|_Fill"), 0, 0, GETTEXT_PACKAGE },
+ /* translators, strip the prefix up to and including the first | */
+ { GTK_STOCK_JUSTIFY_LEFT, N_("Justify|_Left"), 0, 0, GETTEXT_PACKAGE },
+ /* translators, strip the prefix up to and including the first | */
+ { GTK_STOCK_JUSTIFY_RIGHT, N_("Justify|_Right"), 0, 0, GETTEXT_PACKAGE },
+
+ /* translators, strip the prefix up to and including the first | */
+ { GTK_STOCK_MEDIA_FORWARD, N_("Media|_Forward"), 0, 0, GETTEXT_PACKAGE },
+ /* translators, strip the prefix up to and including the first | */
+ { GTK_STOCK_MEDIA_NEXT, N_("Media|_Next"), 0, 0, GETTEXT_PACKAGE },
+ /* translators, strip the prefix up to and including the first | */
+ { GTK_STOCK_MEDIA_PAUSE, N_("Media|P_ause"), 0, 0, GETTEXT_PACKAGE },
+ /* translators, strip the prefix up to and including the first | */
+ { GTK_STOCK_MEDIA_PLAY, N_("Media|_Play"), 0, 0, GETTEXT_PACKAGE },
+ /* translators, strip the prefix up to and including the first | */
+ { GTK_STOCK_MEDIA_PREVIOUS, N_("Media|Pre_vious"), 0, 0, GETTEXT_PACKAGE },
+ /* translators, strip the prefix up to and including the first | */
+ { GTK_STOCK_MEDIA_RECORD, N_("Media|_Record"), 0, 0, GETTEXT_PACKAGE },
+ /* translators, strip the prefix up to and including the first | */
+ { GTK_STOCK_MEDIA_REWIND, N_("Media|R_ewind"), 0, 0, GETTEXT_PACKAGE },
+ /* translators, strip the prefix up to and including the first | */
+ { GTK_STOCK_MEDIA_STOP, N_("Media|_Stop"), 0, 0, GETTEXT_PACKAGE },
+ { GTK_STOCK_NETWORK, N_("_Network"), 0, 0, GETTEXT_PACKAGE },
+ { GTK_STOCK_NEW, N_("_New"), GDK_CONTROL_MASK, 'n', GETTEXT_PACKAGE },
+ { GTK_STOCK_NO, N_("_No"), 0, 0, GETTEXT_PACKAGE },
+ { GTK_STOCK_OK, N_("_OK"), 0, 0, GETTEXT_PACKAGE },
+ { GTK_STOCK_OPEN, N_("_Open"), GDK_CONTROL_MASK, 'o', GETTEXT_PACKAGE },
+ { GTK_STOCK_ORIENTATION_LANDSCAPE, N_("Landscape"), 0, 0, GETTEXT_PACKAGE },
+ { GTK_STOCK_ORIENTATION_PORTRAIT, N_("Portrait"), 0, 0, GETTEXT_PACKAGE },
+ { GTK_STOCK_ORIENTATION_REVERSE_LANDSCAPE, N_("Reverse landscape"), 0, 0, GETTEXT_PACKAGE },
+ { GTK_STOCK_ORIENTATION_REVERSE_PORTRAIT, N_("Reverse portrait"), 0, 0, GETTEXT_PACKAGE },
+ { GTK_STOCK_PAGE_SETUP, N_("Page Set_up"), 0, 0, GETTEXT_PACKAGE },
+ { GTK_STOCK_PASTE, N_("_Paste"), GDK_CONTROL_MASK, 'v', GETTEXT_PACKAGE },
+ { GTK_STOCK_PREFERENCES, N_("_Preferences"), 0, 0, GETTEXT_PACKAGE },
+ { GTK_STOCK_PRINT, N_("_Print"), 0, 0, GETTEXT_PACKAGE },
+ { GTK_STOCK_PRINT_PREVIEW, N_("Print Pre_view"), 0, 0, GETTEXT_PACKAGE },
+ { GTK_STOCK_PROPERTIES, N_("_Properties"), 0, 0, GETTEXT_PACKAGE },
+ { GTK_STOCK_QUIT, N_("_Quit"), GDK_CONTROL_MASK, 'q', GETTEXT_PACKAGE },
+ { GTK_STOCK_REDO, N_("_Redo"), 0, 0, GETTEXT_PACKAGE },
+ { GTK_STOCK_REFRESH, N_("_Refresh"), 0, 0, GETTEXT_PACKAGE },
+ { GTK_STOCK_REMOVE, N_("_Remove"), 0, 0, GETTEXT_PACKAGE },
+ { GTK_STOCK_REVERT_TO_SAVED, N_("_Revert"), 0, 0, GETTEXT_PACKAGE },
+ { GTK_STOCK_SAVE, N_("_Save"), GDK_CONTROL_MASK, 's', GETTEXT_PACKAGE },
+ { GTK_STOCK_SAVE_AS, N_("Save _As"), 0, 0, GETTEXT_PACKAGE },
+ { GTK_STOCK_SELECT_ALL, N_("Select _All"), 0, 0, GETTEXT_PACKAGE },
+ { GTK_STOCK_SELECT_COLOR, N_("_Color"), 0, 0, GETTEXT_PACKAGE },
+ { GTK_STOCK_SELECT_FONT, N_("_Font"), 0, 0, GETTEXT_PACKAGE },
+ { GTK_STOCK_SORT_ASCENDING, N_("_Ascending"), 0, 0, GETTEXT_PACKAGE },
+ { GTK_STOCK_SORT_DESCENDING, N_("_Descending"), 0, 0, GETTEXT_PACKAGE },
+ { GTK_STOCK_SPELL_CHECK, N_("_Spell Check"), 0, 0, GETTEXT_PACKAGE },
+ { GTK_STOCK_STOP, N_("_Stop"), 0, 0, GETTEXT_PACKAGE },
+ { GTK_STOCK_STRIKETHROUGH, N_("_Strikethrough"), 0, 0, GETTEXT_PACKAGE },
+ { GTK_STOCK_UNDELETE, N_("_Undelete"), 0, 0, GETTEXT_PACKAGE },
+ { GTK_STOCK_UNDERLINE, N_("_Underline"), 0, 0, GETTEXT_PACKAGE },
+ { GTK_STOCK_UNDO, N_("_Undo"), 0, 0, GETTEXT_PACKAGE },
+ { GTK_STOCK_YES, N_("_Yes"), 0, 0, GETTEXT_PACKAGE },
+ { GTK_STOCK_ZOOM_100, N_("_Normal Size"), 0, 0, GETTEXT_PACKAGE },
+ { GTK_STOCK_ZOOM_FIT, N_("Best _Fit"), 0, 0, GETTEXT_PACKAGE },
+ { GTK_STOCK_ZOOM_IN, N_("Zoom _In"), 0, 0, GETTEXT_PACKAGE },
+ { GTK_STOCK_ZOOM_OUT, N_("Zoom _Out"), 0, 0, GETTEXT_PACKAGE }
};
+/**
+ * gtk_stock_set_translate_func:
+ * @domain: the translation domain for which @func shall be used
+ * @func: a #GtkTranslateFunc
+ * @data: data to pass to @func
+ * @notify: a #GDestroyNotify that is called when @data is
+ * no longer needed
+ *
+ * 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.
+ *
+ * Since: 2.8
+ *
+ */
+void
+gtk_stock_set_translate_func (const gchar *domain,
+ GtkTranslateFunc func,
+ gpointer data,
+ GDestroyNotify notify)
+{
+ GtkStockTranslateFunc *translate;
+ gchar *domainname;
+
+ domainname = g_strdup (domain);
+
+ translate = (GtkStockTranslateFunc *)
+ g_hash_table_lookup (translate_hash, domainname);
+
+ if (translate)
+ {
+ if (translate->notify)
+ (* translate->notify) (translate->data);
+ }
+ else
+ translate = g_new0 (GtkStockTranslateFunc, 1);
+
+ translate->func = func;
+ translate->data = data;
+ translate->notify = notify;
+
+ g_hash_table_insert (translate_hash, domainname, translate);
+}
+
+static gchar *
+sgettext_swapped (const gchar *msgid,
+ gpointer data)
+{
+ gchar *domainname = data;
+
+ return (gchar *)g_strip_context (msgid, g_dgettext (domainname, msgid));
+}
+
+
static void
init_stock_hash (void)
{
gtk_stock_add_static (builtin_items, G_N_ELEMENTS (builtin_items));
}
+
+ if (translate_hash == NULL)
+ {
+ translate_hash = g_hash_table_new_full (g_str_hash, g_str_equal,
+ g_free, NULL);
+
+ gtk_stock_set_translate_func (GETTEXT_PACKAGE,
+ sgettext_swapped,
+ GETTEXT_PACKAGE,
+ NULL);
+ }
}
+
+#define __GTK_STOCK_C__
+#include "gtkaliasdef.c"