1 <!-- ##### SECTION Title ##### -->
4 <!-- ##### SECTION Short_Description ##### -->
6 Prebuilt common menu/toolbar items and corresponding icons
8 <!-- ##### SECTION Long_Description ##### -->
10 Stock items represent commonly-used menu or toolbar items such as
11 "Open" or "Exit". Each stock item is identified by a stock ID;
12 stock IDs are just strings, but macros such as #GTK_STOCK_OPEN are
13 provided to avoid typing mistakes in the strings.
14 Applications can register their own stock items in addition to those
18 Each stock ID can be associated with a #GtkStockItem, which contains
19 the user-visible label, keyboard accelerator, and translation domain
20 of the menu or toolbar item; and/or with an icon stored in a
21 #GtkIconFactory. See <link
22 linkend="gtk-Themeable-Stock-Images">GtkIconFactory</link> for
23 more information on stock icons. The connection between a
24 #GtkStockItem and stock icons is purely conventional (by virtue of
25 using the same stock ID); it's possible to register a stock item but
26 no icon, and vice versa.
29 <!-- ##### SECTION See_Also ##### -->
34 <!-- ##### STRUCT GtkStockItem ##### -->
45 <!-- ##### FUNCTION gtk_stock_add ##### -->
54 <!-- ##### FUNCTION gtk_stock_add_static ##### -->
63 <!-- ##### FUNCTION gtk_stock_item_copy ##### -->
72 <!-- ##### FUNCTION gtk_stock_item_free ##### -->
80 <!-- ##### FUNCTION gtk_stock_list_ids ##### -->
88 <!-- ##### FUNCTION gtk_stock_lookup ##### -->
98 <!-- ##### MACRO GTK_STOCK_ADD ##### -->
101 <inlinegraphic fileref="stock_add.png" format="png"></inlinegraphic>
106 <!-- ##### MACRO GTK_STOCK_APPLY ##### -->
109 <inlinegraphic fileref="stock_button_apply.png" format="png"></inlinegraphic>
114 <!-- ##### MACRO GTK_STOCK_BOLD ##### -->
117 <inlinegraphic fileref="stock_text_bold.png" format="png"></inlinegraphic>
122 <!-- ##### MACRO GTK_STOCK_CANCEL ##### -->
125 <inlinegraphic fileref="stock_button_cancel.png" format="png"></inlinegraphic>
130 <!-- ##### MACRO GTK_STOCK_CDROM ##### -->
133 <inlinegraphic fileref="stock_cdrom.png" format="png"></inlinegraphic>
138 <!-- ##### MACRO GTK_STOCK_CLEAR ##### -->
141 <inlinegraphic fileref="stock_clear.png" format="png"></inlinegraphic>
146 <!-- ##### MACRO GTK_STOCK_CLOSE ##### -->
149 <inlinegraphic fileref="stock_close.png" format="png"></inlinegraphic>
154 <!-- ##### MACRO GTK_STOCK_CONVERT ##### -->
157 <inlinegraphic fileref="stock_convert.png" format="png"></inlinegraphic>
162 <!-- ##### MACRO GTK_STOCK_COPY ##### -->
165 <inlinegraphic fileref="stock_menu_copy.png" format="png"></inlinegraphic>
170 <!-- ##### MACRO GTK_STOCK_CUT ##### -->
173 <inlinegraphic fileref="stock_menu_cut.png" format="png"></inlinegraphic>
178 <!-- ##### MACRO GTK_STOCK_DELETE ##### -->
181 <inlinegraphic fileref="stock_menu_trash.png" format="png"></inlinegraphic>
186 <!-- ##### MACRO GTK_STOCK_DIALOG_ERROR ##### -->
189 <inlinegraphic fileref="dialog_error.png" format="png"></inlinegraphic>
194 <!-- ##### MACRO GTK_STOCK_DIALOG_INFO ##### -->
196 The "Information" item.
197 <inlinegraphic fileref="dialog_info.png" format="png"></inlinegraphic>
202 <!-- ##### MACRO GTK_STOCK_DIALOG_QUESTION ##### -->
205 <inlinegraphic fileref="dialog_question.png" format="png"></inlinegraphic>
210 <!-- ##### MACRO GTK_STOCK_DIALOG_WARNING ##### -->
213 <inlinegraphic fileref="dialog_warning.png" format="png"></inlinegraphic>
218 <!-- ##### MACRO GTK_STOCK_DND ##### -->
220 The "Drag-And-Drop" icon.
221 <inlinegraphic fileref="stock_dnd.png" format="png"></inlinegraphic>
226 <!-- ##### MACRO GTK_STOCK_DND_MULTIPLE ##### -->
228 The "Drag-And-Drop multiple" icon.
229 <inlinegraphic fileref="stock_dnd_multiple.png" format="png"></inlinegraphic>
234 <!-- ##### MACRO GTK_STOCK_EXECUTE ##### -->
237 <inlinegraphic fileref="stock_exec.png" format="png"></inlinegraphic>
242 <!-- ##### MACRO GTK_STOCK_FIND ##### -->
245 <inlinegraphic fileref="stock_search.png" format="png"></inlinegraphic>
250 <!-- ##### MACRO GTK_STOCK_FIND_AND_REPLACE ##### -->
252 The "Find and Replace" item.
253 <inlinegraphic fileref="stock_search_replace.png" format="png"></inlinegraphic>
258 <!-- ##### MACRO GTK_STOCK_FLOPPY ##### -->
261 <inlinegraphic fileref="stock_save.png" format="png"></inlinegraphic>
266 <!-- ##### MACRO GTK_STOCK_GOTO_BOTTOM ##### -->
269 <inlinegraphic fileref="stock_bottom.png" format="png"></inlinegraphic>
274 <!-- ##### MACRO GTK_STOCK_GOTO_FIRST ##### -->
277 <inlinegraphic fileref="stock_first.png" format="png"></inlinegraphic>
282 <!-- ##### MACRO GTK_STOCK_GOTO_LAST ##### -->
285 <inlinegraphic fileref="stock_last.png" format="png"></inlinegraphic>
290 <!-- ##### MACRO GTK_STOCK_GOTO_TOP ##### -->
293 <inlinegraphic fileref="stock_top.png" format="png"></inlinegraphic>
298 <!-- ##### MACRO GTK_STOCK_GO_BACK ##### -->
301 <inlinegraphic fileref="stock_left_arrow.png" format="png"></inlinegraphic>
306 <!-- ##### MACRO GTK_STOCK_GO_DOWN ##### -->
309 <inlinegraphic fileref="stock_down_arrow.png" format="png"></inlinegraphic>
314 <!-- ##### MACRO GTK_STOCK_GO_FORWARD ##### -->
317 <inlinegraphic fileref="stock_right_arrow.png" format="png"></inlinegraphic>
322 <!-- ##### MACRO GTK_STOCK_GO_UP ##### -->
325 <inlinegraphic fileref="stock_up_arrow.png" format="png"></inlinegraphic>
330 <!-- ##### MACRO GTK_STOCK_HELP ##### -->
333 <inlinegraphic fileref="stock_help.png" format="png"></inlinegraphic>
338 <!-- ##### MACRO GTK_STOCK_HOME ##### -->
341 <inlinegraphic fileref="stock_home.png" format="png"></inlinegraphic>
346 <!-- ##### MACRO GTK_STOCK_INDEX ##### -->
349 <inlinegraphic fileref="stock_index.png" format="png"></inlinegraphic>
354 <!-- ##### MACRO GTK_STOCK_ITALIC ##### -->
357 <inlinegraphic fileref="stock_text_italic.png" format="png"></inlinegraphic>
362 <!-- ##### MACRO GTK_STOCK_JUMP_TO ##### -->
365 <inlinegraphic fileref="stock_jump_to.png" format="png"></inlinegraphic>
370 <!-- ##### MACRO GTK_STOCK_JUSTIFY_CENTER ##### -->
373 <inlinegraphic fileref="stock_align_center.png" format="png"></inlinegraphic>
378 <!-- ##### MACRO GTK_STOCK_JUSTIFY_FILL ##### -->
381 <inlinegraphic fileref="stock_align_justify.png" format="png"></inlinegraphic>
386 <!-- ##### MACRO GTK_STOCK_JUSTIFY_LEFT ##### -->
389 <inlinegraphic fileref="stock_align_left.png" format="png"></inlinegraphic>
394 <!-- ##### MACRO GTK_STOCK_JUSTIFY_RIGHT ##### -->
397 <inlinegraphic fileref="stock_align_right.png" format="png"></inlinegraphic>
402 <!-- ##### MACRO GTK_STOCK_MISSING_IMAGE ##### -->
404 The "Missing image" icon.
405 <inlinegraphic fileref="dialog_error.png" format="png"></inlinegraphic>
410 <!-- ##### MACRO GTK_STOCK_NEW ##### -->
413 <inlinegraphic fileref="stock_new.png" format="png"></inlinegraphic>
418 <!-- ##### MACRO GTK_STOCK_NO ##### -->
421 <inlinegraphic fileref="stock_button_no.png" format="png"></inlinegraphic>
426 <!-- ##### MACRO GTK_STOCK_OK ##### -->
429 <inlinegraphic fileref="stock_button_ok.png" format="png"></inlinegraphic>
434 <!-- ##### MACRO GTK_STOCK_OPEN ##### -->
437 <inlinegraphic fileref="stock_open.png" format="png"></inlinegraphic>
442 <!-- ##### MACRO GTK_STOCK_PASTE ##### -->
445 <inlinegraphic fileref="stock_paste.png" format="png"></inlinegraphic>
450 <!-- ##### MACRO GTK_STOCK_PREFERENCES ##### -->
452 The "Preferences" item.
453 <inlinegraphic fileref="stock_preferences.png" format="png"></inlinegraphic>
458 <!-- ##### MACRO GTK_STOCK_PRINT ##### -->
461 <inlinegraphic fileref="stock_print.png" format="png"></inlinegraphic>
466 <!-- ##### MACRO GTK_STOCK_PRINT_PREVIEW ##### -->
468 The "Print Preview" item.
469 <inlinegraphic fileref="stock_print_preview.png" format="png"></inlinegraphic>
474 <!-- ##### MACRO GTK_STOCK_PROPERTIES ##### -->
476 The "Properties" item.
477 <inlinegraphic fileref="stock_properties.png" format="png"></inlinegraphic>
482 <!-- ##### MACRO GTK_STOCK_QUIT ##### -->
485 <inlinegraphic fileref="stock_exit.png" format="png"></inlinegraphic>
490 <!-- ##### MACRO GTK_STOCK_REDO ##### -->
493 <inlinegraphic fileref="stock_redo.png" format="png"></inlinegraphic>
498 <!-- ##### MACRO GTK_STOCK_REFRESH ##### -->
501 <inlinegraphic fileref="stock_refresh.png" format="png"></inlinegraphic>
506 <!-- ##### MACRO GTK_STOCK_REMOVE ##### -->
509 <inlinegraphic fileref="stock_remove.png" format="png"></inlinegraphic>
514 <!-- ##### MACRO GTK_STOCK_REVERT_TO_SAVED ##### -->
517 <inlinegraphic fileref="stock_revert.png" format="png"></inlinegraphic>
522 <!-- ##### MACRO GTK_STOCK_SAVE ##### -->
525 <inlinegraphic fileref="stock_save.png" format="png"></inlinegraphic>
530 <!-- ##### MACRO GTK_STOCK_SAVE_AS ##### -->
533 <inlinegraphic fileref="stock_save_as.png" format="png"></inlinegraphic>
538 <!-- ##### MACRO GTK_STOCK_SELECT_COLOR ##### -->
541 <inlinegraphic fileref="stock_colorselector.png" format="png"></inlinegraphic>
546 <!-- ##### MACRO GTK_STOCK_SELECT_FONT ##### -->
549 <inlinegraphic fileref="stock_font.png" format="png"></inlinegraphic>
554 <!-- ##### MACRO GTK_STOCK_SORT_ASCENDING ##### -->
556 The "Ascending" item.
557 <inlinegraphic fileref="stock_sort_ascending.png" format="png"></inlinegraphic>
562 <!-- ##### MACRO GTK_STOCK_SORT_DESCENDING ##### -->
564 The "Descending" item.
565 <inlinegraphic fileref="stock_sort_descending.png" format="png"></inlinegraphic>
570 <!-- ##### MACRO GTK_STOCK_SPELL_CHECK ##### -->
572 The "Spell Check" item.
573 <inlinegraphic fileref="stock_spellcheck.png" format="png"></inlinegraphic>
578 <!-- ##### MACRO GTK_STOCK_STOP ##### -->
581 <inlinegraphic fileref="stock_stop.png" format="png"></inlinegraphic>
586 <!-- ##### MACRO GTK_STOCK_STRIKETHROUGH ##### -->
588 The "Strikethrough" item.
589 <inlinegraphic fileref="stock_text_strikeout.png" format="png"></inlinegraphic>
594 <!-- ##### MACRO GTK_STOCK_UNDELETE ##### -->
597 <inlinegraphic fileref="stock_undelete.png" format="png"></inlinegraphic>
602 <!-- ##### MACRO GTK_STOCK_UNDERLINE ##### -->
604 The "Underline" item.
605 <inlinegraphic fileref="stock_text_underline.png" format="png"></inlinegraphic>
610 <!-- ##### MACRO GTK_STOCK_UNDO ##### -->
613 <inlinegraphic fileref="stock_undo.png" format="png"></inlinegraphic>
618 <!-- ##### MACRO GTK_STOCK_YES ##### -->
621 <inlinegraphic fileref="stock_button_yes.png" format="png"></inlinegraphic>
626 <!-- ##### MACRO GTK_STOCK_ZOOM_100 ##### -->
628 The "Zoom 100%" item.
629 <inlinegraphic fileref="stock_zoom_1.png" format="png"></inlinegraphic>
634 <!-- ##### MACRO GTK_STOCK_ZOOM_FIT ##### -->
636 The "Zoom to Fit" item.
637 <inlinegraphic fileref="stock_zoom_fit.png" format="png"></inlinegraphic>
642 <!-- ##### MACRO GTK_STOCK_ZOOM_IN ##### -->
645 <inlinegraphic fileref="stock_zoom_in.png" format="png"></inlinegraphic>
650 <!-- ##### MACRO GTK_STOCK_ZOOM_OUT ##### -->
653 <inlinegraphic fileref="stock_zoom_out.png" format="png"></inlinegraphic>