1
2@c %start of fragment
3
4@node Stock Items
5@chapter Stock Items
6Prebuilt common menu/toolbar items and corresponding icons
7
8@section Overview
9Stock items represent commonly-used menu or toolbar items such as "Open" or
10"Exit". Each stock item is identified by a stock ID; stock IDs are just strings,
11but macros such as @code{<gtk-stock-open>} are provided to avoid typing mistakes
12in the strings. Applications can register their own stock items in addition to
13those built-in to GTK+.
14
15Each stock ID can be associated with a @code{<gtk-stock-item>}, which contains
16the user-visible label, keyboard accelerator, and translation domain of the menu
17or toolbar item; and/or with an icon stored in a @code{<gtk-icon-factory>}. See
18GtkIconFactory for more information on stock icons. The connection between a
19@code{<gtk-stock-item>} and stock icons is purely conventional (by virtue of
20using the same stock ID); it's possible to register a stock item but no icon,
21and vice versa. Stock icons may have a RTL variant which gets used for
22right-to-left locales.
23
24@section Usage
25@include defuns-gtkstock.xml.texi
26
27@c %end of fragment
28