Stock Items

			GTK+ Reference Manual
Top \| Description

Заготовленные элементы

Stock Items Предварительно подготовленные, основные элементы меню/инструментальных панелей и соответствующие значки.

Краткий обзор

#include <gtk/gtk.h>


            GtkStockItem;
void        gtk_stock_add                   (const GtkStockItem *items,
                                             guint n_items);
void        gtk_stock_add_static            (const GtkStockItem *items,
                                             guint n_items);
GtkStockItem* gtk_stock_item_copy           (const GtkStockItem *item);
void        gtk_stock_item_free             (GtkStockItem *item);
GSList*     gtk_stock_list_ids              (void);
gboolean    gtk_stock_lookup                (const gchar *stock_id,
                                             GtkStockItem *item);
void        gtk_stock_set_translate_func    (const gchar *domain,
                                             GtkTranslateFunc func,
                                             gpointer data,
                                             GtkDestroyNotify notify);

#define     GTK_STOCK_ABOUT
#define     GTK_STOCK_ADD
#define     GTK_STOCK_APPLY
#define     GTK_STOCK_BOLD
#define     GTK_STOCK_CANCEL
#define     GTK_STOCK_CDROM
#define     GTK_STOCK_CLEAR
#define     GTK_STOCK_CLOSE
#define     GTK_STOCK_COLOR_PICKER
#define     GTK_STOCK_CONVERT
#define     GTK_STOCK_CONNECT
#define     GTK_STOCK_COPY
#define     GTK_STOCK_CUT
#define     GTK_STOCK_DELETE
#define     GTK_STOCK_DIALOG_AUTHENTICATION
#define     GTK_STOCK_DIALOG_ERROR
#define     GTK_STOCK_DIALOG_INFO
#define     GTK_STOCK_DIALOG_QUESTION
#define     GTK_STOCK_DIALOG_WARNING
#define     GTK_STOCK_DIRECTORY
#define     GTK_STOCK_DISCONNECT
#define     GTK_STOCK_DND
#define     GTK_STOCK_DND_MULTIPLE
#define     GTK_STOCK_EDIT
#define     GTK_STOCK_EXECUTE
#define     GTK_STOCK_FILE
#define     GTK_STOCK_FIND
#define     GTK_STOCK_FIND_AND_REPLACE
#define     GTK_STOCK_FLOPPY
#define     GTK_STOCK_FULLSCREEN
#define     GTK_STOCK_GOTO_BOTTOM
#define     GTK_STOCK_GOTO_FIRST
#define     GTK_STOCK_GOTO_LAST
#define     GTK_STOCK_GOTO_TOP
#define     GTK_STOCK_GO_BACK
#define     GTK_STOCK_GO_DOWN
#define     GTK_STOCK_GO_FORWARD
#define     GTK_STOCK_GO_UP
#define     GTK_STOCK_HARDDISK
#define     GTK_STOCK_HELP
#define     GTK_STOCK_HOME
#define     GTK_STOCK_INDENT
#define     GTK_STOCK_INDEX
#define     GTK_STOCK_INFO
#define     GTK_STOCK_ITALIC
#define     GTK_STOCK_JUMP_TO
#define     GTK_STOCK_JUSTIFY_CENTER
#define     GTK_STOCK_JUSTIFY_FILL
#define     GTK_STOCK_JUSTIFY_LEFT
#define     GTK_STOCK_JUSTIFY_RIGHT
#define     GTK_STOCK_LEAVE_FULLSCREEN
#define     GTK_STOCK_MEDIA_FORWARD
#define     GTK_STOCK_MEDIA_NEXT
#define     GTK_STOCK_MEDIA_PAUSE
#define     GTK_STOCK_MEDIA_PLAY
#define     GTK_STOCK_MEDIA_PREVIOUS
#define     GTK_STOCK_MEDIA_RECORD
#define     GTK_STOCK_MEDIA_REWIND
#define     GTK_STOCK_MEDIA_STOP
#define     GTK_STOCK_MISSING_IMAGE
#define     GTK_STOCK_NETWORK
#define     GTK_STOCK_NEW
#define     GTK_STOCK_NO
#define     GTK_STOCK_OK
#define     GTK_STOCK_OPEN
#define     GTK_STOCK_PASTE
#define     GTK_STOCK_PREFERENCES
#define     GTK_STOCK_PRINT
#define     GTK_STOCK_PRINT_PREVIEW
#define     GTK_STOCK_PROPERTIES
#define     GTK_STOCK_QUIT
#define     GTK_STOCK_REDO
#define     GTK_STOCK_REFRESH
#define     GTK_STOCK_REMOVE
#define     GTK_STOCK_REVERT_TO_SAVED
#define     GTK_STOCK_SAVE
#define     GTK_STOCK_SAVE_AS
#define     GTK_STOCK_SELECT_COLOR
#define     GTK_STOCK_SELECT_FONT
#define     GTK_STOCK_SORT_ASCENDING
#define     GTK_STOCK_SORT_DESCENDING
#define     GTK_STOCK_SPELL_CHECK
#define     GTK_STOCK_STOP
#define     GTK_STOCK_STRIKETHROUGH
#define     GTK_STOCK_UNDELETE
#define     GTK_STOCK_UNDERLINE
#define     GTK_STOCK_UNDO
#define     GTK_STOCK_UNINDENT
#define     GTK_STOCK_YES
#define     GTK_STOCK_ZOOM_100
#define     GTK_STOCK_ZOOM_FIT
#define     GTK_STOCK_ZOOM_IN
#define     GTK_STOCK_ZOOM_OUT

Описание

Заготовленные элементы представляют часто используемые, обычные элементы меню или панелей инструментов, такие как "Open" или "Exit". Каждый заготовленный элемент идентифицируется ID; IDs заготовок, это просто строки, но макрос, такой как GTK_STOCK_OPEN обеспечивает отсутствие ошибок в строках. Приложения могут регистрировать собственные заготовленные элементы в дополнение к встроенным в GTK+.

Каждый заготовленный ID может быть связан с GtkStockItem, который содержит видимые пользователем ярлыки, акселераторы клавиатуры и область преобразования меню или панели инструментов; и/или с сохранённым значком в GtkIconFactory. Смотрите GtkIconFactory для подробной информации о заготовленных значках. Выполнить соединение между GtkStockItem и заготовленными значками обычно просто (используя тот же самый заготовленный ID); это позволяет регистрировать заготовленный элемент но не значок, и наоборот. Заготовленные значки могут иметь вариант RTL который используется для обратно направленных (справа-на-лево/right-to-left) локалей.

Детали

GtkStockItem

typedef struct {
  gchar *stock_id;
  gchar *label;
  GdkModifierType modifier;
  guint keyval;
  gchar *translation_domain;
} GtkStockItem;

gtk_stock_add ()

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

Регистрирует каждый заготовленный элемент в items. Если элемент существует с тем же самым заготовленным ID как один из items, старые элементы переписываются. Заготовленные элементы копируются, таким образом GTK+ не удерживает никакого указателя в items и items может быть освобождён. Используйте gtk_stock_add_static() если items постоянны и GTK+ не нужно копировать массив.

`items` :	GtkStockItem или массив элементов
`n_items` :	число GtkStockItem в `items`

gtk_stock_add_static ()

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

Тоже самое как gtk_stock_add(), но не делает копии items, поэтому items должны сохраняться до выхода из приложения.

`items` :	GtkStockItem или массив GtkStockItem
`n_items` :	Число элементов

gtk_stock_item_copy ()

GtkStockItem* gtk_stock_item_copy (const GtkStockItem *item);

Копирует заготовленные элементы, главным образом полезно для языковых привязок, а не для приложений.

`item` :	GtkStockItem
Возвращает :	Новый GtkStockItem

gtk_stock_item_free ()

void gtk_stock_item_free (GtkStockItem *item);

Освобождает элемент расположенный в массе, такой как возвращаемый gtk_stock_item_copy(). Также освобождаются поля в заготовленных элементах, если они не NULL.

item :

GtkStockItem

gtk_stock_list_ids ()

GSList* gtk_stock_list_ids (void);

Отыскивает список всех известных заготовленных IDs добавляемых GtkIconFactory, или регистрируемых с помощью gtk_stock_add(). Список должен быть освобождён с помощью g_slist_free(), а каждая строка в списке должна быть освобождена при помощи g_free().

Возвращает :

Список известных заготовленных IDs

gtk_stock_lookup ()

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

Заполняет item зарегистрированными значениями для stock_id, возвращает TRUE если stock_id был известен.

`stock_id` :	Имя заготовленного элемента
`item` :	Заготовленный элемент с инициализированными значениями
Возвращает :	`TRUE` если `item` инициализировано

gtk_stock_set_translate_func ()

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

Устанавливает функцию для перевода label заготовленного элемента.

Если нет функции зарегистрированной для перевода области, используется dgettext().

`domain` :	Переводимая область для которой должна использоваться `func` .
`func` :	GtkTranslateFunc
`data` :	Данные помещаемые в `func`
`notify` :	GtkDestroyNotify который вызывается когда `data` больше не нужна.

Начиная с версии 2.8

GTK_STOCK_ABOUT

#define GTK_STOCK_ABOUT "gtk-about"

Элемент "About".

Начиная с версии 2.6

GTK_STOCK_ADD

#define GTK_STOCK_ADD "gtk-add"

Элемент "Add".

GTK_STOCK_APPLY

#define GTK_STOCK_APPLY "gtk-apply"

Элемент "Apply".

GTK_STOCK_BOLD

#define GTK_STOCK_BOLD "gtk-bold"

Элемент "Bold".

GTK_STOCK_CANCEL

#define GTK_STOCK_CANCEL "gtk-cancel"

Элемент "Cancel".

GTK_STOCK_CDROM

#define GTK_STOCK_CDROM "gtk-cdrom"

Элемент "CD-Rom".

GTK_STOCK_CLEAR

#define GTK_STOCK_CLEAR "gtk-clear"

Элемент "Clear".

GTK_STOCK_CLOSE

#define GTK_STOCK_CLOSE "gtk-close"

Элемент "Close".

GTK_STOCK_COLOR_PICKER

#define GTK_STOCK_COLOR_PICKER "gtk-color-picker"

Элемент "Color Picker".

Начиная с версии 2.2

GTK_STOCK_CONVERT

#define GTK_STOCK_CONVERT "gtk-convert"

Элемент "Convert".

GTK_STOCK_CONNECT

#define GTK_STOCK_CONNECT "gtk-connect"

Элемент "Connect" icon.

Начиная с версии 2.6

GTK_STOCK_COPY

#define GTK_STOCK_COPY "gtk-copy"

Элемент "Copy".

GTK_STOCK_CUT

#define GTK_STOCK_CUT "gtk-cut"

Элемент "Cut".

GTK_STOCK_DELETE

#define GTK_STOCK_DELETE "gtk-delete"

Элемент "Delete".

GTK_STOCK_DIALOG_AUTHENTICATION

#define GTK_STOCK_DIALOG_AUTHENTICATION

Элемент "Authentication".

Начиная с версии 2.4

GTK_STOCK_DIALOG_ERROR

#define GTK_STOCK_DIALOG_ERROR "gtk-dialog-error"

Элемент "Error".

GTK_STOCK_DIALOG_INFO

#define GTK_STOCK_DIALOG_INFO "gtk-dialog-info"

Элемент "Information".

GTK_STOCK_DIALOG_QUESTION

#define GTK_STOCK_DIALOG_QUESTION "gtk-dialog-question"

Элемент "Question".

GTK_STOCK_DIALOG_WARNING

#define GTK_STOCK_DIALOG_WARNING "gtk-dialog-warning"

Элемент "Warning".

GTK_STOCK_DIRECTORY

#define GTK_STOCK_DIRECTORY "gtk-directory"

Элемент "Directory" icon.

Начиная с версии 2.6

GTK_STOCK_DISCONNECT

#define GTK_STOCK_DISCONNECT "gtk-disconnect"

Элемент "Disconnect" icon.

Начиная с версии 2.6

GTK_STOCK_DND

#define GTK_STOCK_DND "gtk-dnd"

Элемент "Drag-And-Drop" icon.

GTK_STOCK_DND_MULTIPLE

#define GTK_STOCK_DND_MULTIPLE "gtk-dnd-multiple"

Элемент "Drag-And-Drop multiple" icon.

GTK_STOCK_EDIT

#define GTK_STOCK_EDIT "gtk-edit"

Элемент "Edit".

Начиная с версии 2.6

GTK_STOCK_EXECUTE

#define GTK_STOCK_EXECUTE "gtk-execute"

Элемент "Execute".

GTK_STOCK_FILE

#define GTK_STOCK_FILE "gtk-file"

Элемент "File" icon.

Начиная с версии 2.6

GTK_STOCK_FIND

#define GTK_STOCK_FIND "gtk-find"

Элемент "Find".

GTK_STOCK_FIND_AND_REPLACE

#define GTK_STOCK_FIND_AND_REPLACE "gtk-find-and-replace"

Элемент "Find and Replace".

GTK_STOCK_FLOPPY

#define GTK_STOCK_FLOPPY "gtk-floppy"

Элемент "Floppy".

GTK_STOCK_FULLSCREEN

#define GTK_STOCK_FULLSCREEN "gtk-fullscreen"

Элемент "Fullscreen".

Начиная с версии 2.8

GTK_STOCK_GOTO_BOTTOM

#define GTK_STOCK_GOTO_BOTTOM "gtk-goto-bottom"

Элемент "Bottom".

GTK_STOCK_GOTO_FIRST

#define GTK_STOCK_GOTO_FIRST "gtk-goto-first"

Элемент "First". вариант RTL

GTK_STOCK_GOTO_LAST

#define GTK_STOCK_GOTO_LAST "gtk-goto-last"

Элемент "Last". вариант RTL

GTK_STOCK_GOTO_TOP

#define GTK_STOCK_GOTO_TOP "gtk-goto-top"

Элемент "Top".

GTK_STOCK_GO_BACK

#define GTK_STOCK_GO_BACK "gtk-go-back"

Элемент "Back". вариант RTL

GTK_STOCK_GO_DOWN

#define GTK_STOCK_GO_DOWN "gtk-go-down"

Элемент "Down".

GTK_STOCK_GO_FORWARD

#define GTK_STOCK_GO_FORWARD "gtk-go-forward"

Элемент "Forward". вариант RTL

GTK_STOCK_GO_UP

#define GTK_STOCK_GO_UP "gtk-go-up"

Элемент "Up".

GTK_STOCK_HARDDISK

#define GTK_STOCK_HARDDISK "gtk-harddisk"

Элемент "Harddisk".

Начиная с версии 2.4

GTK_STOCK_HELP

#define GTK_STOCK_HELP "gtk-help"

Элемент "Help".

GTK_STOCK_HOME

#define GTK_STOCK_HOME "gtk-home"

Элемент "Home".

GTK_STOCK_INDENT

#define GTK_STOCK_INDENT "gtk-indent"

Элемент "Indent".

Начиная с версии 2.4

GTK_STOCK_INDEX

#define GTK_STOCK_INDEX "gtk-index"

Элемент "Index".

GTK_STOCK_INFO

#define GTK_STOCK_INFO "gtk-info"

Элемент "Info".

Начиная с версии 2.8

GTK_STOCK_ITALIC

#define GTK_STOCK_ITALIC "gtk-italic"

Элемент "Italic".

GTK_STOCK_JUMP_TO

#define GTK_STOCK_JUMP_TO "gtk-jump-to"

Элемент "Jump to". RTL-variant

GTK_STOCK_JUSTIFY_CENTER

#define GTK_STOCK_JUSTIFY_CENTER "gtk-justify-center"

Элемент "Center".

GTK_STOCK_JUSTIFY_FILL

#define GTK_STOCK_JUSTIFY_FILL "gtk-justify-fill"

Элемент "Fill".

GTK_STOCK_JUSTIFY_LEFT

#define GTK_STOCK_JUSTIFY_LEFT "gtk-justify-left"

Элемент "Left".

GTK_STOCK_JUSTIFY_RIGHT

#define GTK_STOCK_JUSTIFY_RIGHT "gtk-justify-right"

Элемент "Right".

GTK_STOCK_LEAVE_FULLSCREEN

#define GTK_STOCK_LEAVE_FULLSCREEN "gtk-leave-fullscreen"

Элемент "Leave Fullscreen".

Начиная с версии 2.8

GTK_STOCK_MEDIA_FORWARD

#define GTK_STOCK_MEDIA_FORWARD "gtk-media-forward"

Элемент "Media Forward". вариант RTL

Начиная с версии 2.6

GTK_STOCK_MEDIA_NEXT

#define GTK_STOCK_MEDIA_NEXT "gtk-media-next"

Элемент "Media Next". вариант RTL

Начиная с версии 2.6

GTK_STOCK_MEDIA_PAUSE

#define GTK_STOCK_MEDIA_PAUSE "gtk-media-pause"

Элемент "Media Pause".

Начиная с версии 2.6

GTK_STOCK_MEDIA_PLAY

#define GTK_STOCK_MEDIA_PLAY "gtk-media-play"

Элемент "Media Play". вариант RTL

Начиная с версии 2.6

GTK_STOCK_MEDIA_PREVIOUS

#define GTK_STOCK_MEDIA_PREVIOUS "gtk-media-previous"

Элемент "Media Previous". вариант RTL

Начиная с версии 2.6

GTK_STOCK_MEDIA_RECORD

#define GTK_STOCK_MEDIA_RECORD "gtk-media-record"

Элемент "Media Record".

Начиная с версии 2.6

GTK_STOCK_MEDIA_REWIND

#define GTK_STOCK_MEDIA_REWIND "gtk-media-rewind"

Элемент "Media Rewind". вариант RTL

Начиная с версии 2.6

GTK_STOCK_MEDIA_STOP

#define GTK_STOCK_MEDIA_STOP "gtk-media-stop"

Элемент "Media Stop".

Начиная с версии 2.6

GTK_STOCK_MISSING_IMAGE

#define GTK_STOCK_MISSING_IMAGE "gtk-missing-image"

Элемент "Missing image" icon.

GTK_STOCK_NETWORK

#define GTK_STOCK_NETWORK "gtk-network"

Элемент "Network".

Начиная с версии 2.4

GTK_STOCK_NEW

#define GTK_STOCK_NEW "gtk-new"

Элемент "New".

GTK_STOCK_NO

#define GTK_STOCK_NO "gtk-no"

Элемент "No".

GTK_STOCK_OK

#define GTK_STOCK_OK "gtk-ok"

Элемент "OK".

GTK_STOCK_OPEN

#define GTK_STOCK_OPEN "gtk-open"

Элемент "Open".

GTK_STOCK_PASTE

#define GTK_STOCK_PASTE "gtk-paste"

Элемент "Paste".

GTK_STOCK_PREFERENCES

#define GTK_STOCK_PREFERENCES "gtk-preferences"

Элемент "Preferences".

GTK_STOCK_PRINT

#define GTK_STOCK_PRINT "gtk-print"

Элемент "Print".

GTK_STOCK_PRINT_PREVIEW

#define GTK_STOCK_PRINT_PREVIEW "gtk-print-preview"

Элемент "Print Preview".

GTK_STOCK_PROPERTIES

#define GTK_STOCK_PROPERTIES "gtk-properties"

Элемент "Properties".

GTK_STOCK_QUIT

#define GTK_STOCK_QUIT "gtk-quit"

Элемент "Quit".

GTK_STOCK_REDO

#define GTK_STOCK_REDO "gtk-redo"

Элемент "Redo". вариант RTL

GTK_STOCK_REFRESH

#define GTK_STOCK_REFRESH "gtk-refresh"

Элемент "Refresh".

GTK_STOCK_REMOVE

#define GTK_STOCK_REMOVE "gtk-remove"

Элемент "Remove".

GTK_STOCK_REVERT_TO_SAVED

#define GTK_STOCK_REVERT_TO_SAVED "gtk-revert-to-saved"

Элемент "Revert". вариант RTL

GTK_STOCK_SAVE

#define GTK_STOCK_SAVE "gtk-save"

Элемент "Save".

GTK_STOCK_SAVE_AS

#define GTK_STOCK_SAVE_AS "gtk-save-as"

Элемент "Save As".

GTK_STOCK_SELECT_COLOR

#define GTK_STOCK_SELECT_COLOR "gtk-select-color"

Элемент "Color".

GTK_STOCK_SELECT_FONT

#define GTK_STOCK_SELECT_FONT "gtk-select-font"

Элемент "Font".

GTK_STOCK_SORT_ASCENDING

#define GTK_STOCK_SORT_ASCENDING "gtk-sort-ascending"

Элемент "Ascending".

GTK_STOCK_SORT_DESCENDING

#define GTK_STOCK_SORT_DESCENDING "gtk-sort-descending"

Элемент "Descending".

GTK_STOCK_SPELL_CHECK

#define GTK_STOCK_SPELL_CHECK "gtk-spell-check"

Элемент "Spell Check".

GTK_STOCK_STOP

#define GTK_STOCK_STOP "gtk-stop"

Элемент "Stop".

GTK_STOCK_STRIKETHROUGH

#define GTK_STOCK_STRIKETHROUGH "gtk-strikethrough"

Элемент "Strikethrough".

GTK_STOCK_UNDELETE

#define GTK_STOCK_UNDELETE "gtk-undelete"

Элемент "Undelete". вариант RTL

GTK_STOCK_UNDERLINE

#define GTK_STOCK_UNDERLINE "gtk-underline"

Элемент "Underline".

GTK_STOCK_UNDO

#define GTK_STOCK_UNDO "gtk-undo"

Элемент "Undo". вариант RTL

GTK_STOCK_UNINDENT

#define GTK_STOCK_UNINDENT "gtk-unindent"

Элемент "Unindent".

Начиная с версии 2.4

GTK_STOCK_YES

#define GTK_STOCK_YES "gtk-yes"

Элемент "Yes".

GTK_STOCK_ZOOM_100

#define GTK_STOCK_ZOOM_100 "gtk-zoom-100"

Элемент "Zoom 100%".

GTK_STOCK_ZOOM_FIT

#define GTK_STOCK_ZOOM_FIT "gtk-zoom-fit"

Элемент "Zoom to Fit".

GTK_STOCK_ZOOM_IN

#define GTK_STOCK_ZOOM_IN "gtk-zoom-in"

Элемент "Zoom In".

GTK_STOCK_ZOOM_OUT

#define GTK_STOCK_ZOOM_OUT "gtk-zoom-out"

Элемент "Zoom Out".