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. Stock icons may have a RTL variant which gets
27 used for right-to-left locales.
30 <!-- ##### SECTION See_Also ##### -->
35 <!-- ##### SECTION Stability_Level ##### -->
38 <!-- ##### STRUCT GtkStockItem ##### -->
49 <!-- ##### FUNCTION gtk_stock_add ##### -->
58 <!-- ##### FUNCTION gtk_stock_add_static ##### -->
67 <!-- ##### FUNCTION gtk_stock_item_copy ##### -->
76 <!-- ##### FUNCTION gtk_stock_item_free ##### -->
84 <!-- ##### FUNCTION gtk_stock_list_ids ##### -->
92 <!-- ##### FUNCTION gtk_stock_lookup ##### -->
102 <!-- ##### FUNCTION gtk_stock_set_translate_func ##### -->
113 <!-- ##### MACRO GTK_STOCK_ABOUT ##### -->
116 <inlinegraphic fileref="gtk-about.png" format="PNG"></inlinegraphic>
122 <!-- ##### MACRO GTK_STOCK_ADD ##### -->
125 <inlinegraphic fileref="gtk-add.png" format="PNG"></inlinegraphic>
130 <!-- ##### MACRO GTK_STOCK_APPLY ##### -->
133 <inlinegraphic fileref="gtk-apply.png" format="PNG"></inlinegraphic>
138 <!-- ##### MACRO GTK_STOCK_BOLD ##### -->
141 <inlinegraphic fileref="gtk-bold.png" format="PNG"></inlinegraphic>
146 <!-- ##### MACRO GTK_STOCK_CANCEL ##### -->
149 <inlinegraphic fileref="gtk-cancel.png" format="PNG"></inlinegraphic>
154 <!-- ##### MACRO GTK_STOCK_CDROM ##### -->
157 <inlinegraphic fileref="gtk-cdrom.png" format="PNG"></inlinegraphic>
162 <!-- ##### MACRO GTK_STOCK_CLEAR ##### -->
165 <inlinegraphic fileref="gtk-clear.png" format="PNG"></inlinegraphic>
170 <!-- ##### MACRO GTK_STOCK_CLOSE ##### -->
173 <inlinegraphic fileref="gtk-close.png" format="PNG"></inlinegraphic>
178 <!-- ##### MACRO GTK_STOCK_COLOR_PICKER ##### -->
180 The "Color Picker" item.
181 <inlinegraphic fileref="gtk-color-picker.png" format="PNG"></inlinegraphic>
187 <!-- ##### MACRO GTK_STOCK_CONVERT ##### -->
190 <inlinegraphic fileref="gtk-convert.png" format="PNG"></inlinegraphic>
195 <!-- ##### MACRO GTK_STOCK_CONNECT ##### -->
198 <inlinegraphic fileref="gtk-connect.png" format="PNG"></inlinegraphic>
204 <!-- ##### MACRO GTK_STOCK_COPY ##### -->
207 <inlinegraphic fileref="gtk-copy.png" format="PNG"></inlinegraphic>
212 <!-- ##### MACRO GTK_STOCK_CUT ##### -->
215 <inlinegraphic fileref="gtk-cut.png" format="PNG"></inlinegraphic>
220 <!-- ##### MACRO GTK_STOCK_DELETE ##### -->
223 <inlinegraphic fileref="gtk-delete.png" format="PNG"></inlinegraphic>
228 <!-- ##### MACRO GTK_STOCK_DIALOG_AUTHENTICATION ##### -->
230 The "Authentication" item.
231 <inlinegraphic fileref="gtk-dialog-authentication.png" format="PNG"></inlinegraphic>
237 <!-- ##### MACRO GTK_STOCK_DIALOG_ERROR ##### -->
240 <inlinegraphic fileref="gtk-dialog-error.png" format="PNG"></inlinegraphic>
245 <!-- ##### MACRO GTK_STOCK_DIALOG_INFO ##### -->
247 The "Information" item.
248 <inlinegraphic fileref="gtk-dialog-info.png" format="PNG"></inlinegraphic>
253 <!-- ##### MACRO GTK_STOCK_DIALOG_QUESTION ##### -->
256 <inlinegraphic fileref="gtk-dialog-question.png" format="PNG"></inlinegraphic>
261 <!-- ##### MACRO GTK_STOCK_DIALOG_WARNING ##### -->
264 <inlinegraphic fileref="gtk-dialog-warning.png" format="PNG"></inlinegraphic>
269 <!-- ##### MACRO GTK_STOCK_DIRECTORY ##### -->
271 The "Directory" icon.
272 <inlinegraphic fileref="gtk-directory.png" format="PNG"></inlinegraphic>
278 <!-- ##### MACRO GTK_STOCK_DISCARD ##### -->
286 <!-- ##### MACRO GTK_STOCK_DISCONNECT ##### -->
288 The "Disconnect" icon.
289 <inlinegraphic fileref="gtk-disconnect.png" format="PNG"></inlinegraphic>
295 <!-- ##### MACRO GTK_STOCK_DND ##### -->
297 The "Drag-And-Drop" icon.
298 <inlinegraphic fileref="gtk-dnd.png" format="PNG"></inlinegraphic>
303 <!-- ##### MACRO GTK_STOCK_DND_MULTIPLE ##### -->
305 The "Drag-And-Drop multiple" icon.
306 <inlinegraphic fileref="gtk-dnd-multiple.png" format="PNG"></inlinegraphic>
311 <!-- ##### MACRO GTK_STOCK_EDIT ##### -->
314 <inlinegraphic fileref="gtk-edit.png" format="PNG"></inlinegraphic>
320 <!-- ##### MACRO GTK_STOCK_EXECUTE ##### -->
323 <inlinegraphic fileref="gtk-execute.png" format="PNG"></inlinegraphic>
328 <!-- ##### MACRO GTK_STOCK_FILE ##### -->
332 <inlinegraphic fileref="gtk-file.png" format="PNG"></inlinegraphic>
339 <!-- ##### MACRO GTK_STOCK_FIND ##### -->
342 <inlinegraphic fileref="gtk-find.png" format="PNG"></inlinegraphic>
347 <!-- ##### MACRO GTK_STOCK_FIND_AND_REPLACE ##### -->
349 The "Find and Replace" item.
350 <inlinegraphic fileref="gtk-find-and-replace.png" format="PNG"></inlinegraphic>
355 <!-- ##### MACRO GTK_STOCK_FLOPPY ##### -->
358 <inlinegraphic fileref="gtk-floppy.png" format="PNG"></inlinegraphic>
363 <!-- ##### MACRO GTK_STOCK_FULLSCREEN ##### -->
365 The "Fullscreen" item.
366 <inlinegraphic fileref="gtk-fullscreen.png" format="PNG"></inlinegraphic>
372 <!-- ##### MACRO GTK_STOCK_GOTO_BOTTOM ##### -->
375 <inlinegraphic fileref="gtk-goto-bottom.png" format="PNG"></inlinegraphic>
380 <!-- ##### MACRO GTK_STOCK_GOTO_FIRST ##### -->
383 <inlinegraphic fileref="gtk-goto-first-ltr.png" format="PNG"></inlinegraphic>
385 <inlinegraphic fileref="gtk-goto-first-rtl.png" format="PNG"></inlinegraphic>
390 <!-- ##### MACRO GTK_STOCK_GOTO_LAST ##### -->
393 <inlinegraphic fileref="gtk-goto-last-ltr.png" format="PNG"></inlinegraphic>
395 <inlinegraphic fileref="gtk-goto-last-rtl.png" format="PNG"></inlinegraphic>
400 <!-- ##### MACRO GTK_STOCK_GOTO_TOP ##### -->
403 <inlinegraphic fileref="gtk-goto-top.png" format="PNG"></inlinegraphic>
408 <!-- ##### MACRO GTK_STOCK_GO_BACK ##### -->
411 <inlinegraphic fileref="gtk-go-back-ltr.png" format="PNG"></inlinegraphic>
413 <inlinegraphic fileref="gtk-go-back-rtl.png" format="PNG"></inlinegraphic>
418 <!-- ##### MACRO GTK_STOCK_GO_DOWN ##### -->
421 <inlinegraphic fileref="gtk-go-down.png" format="PNG"></inlinegraphic>
426 <!-- ##### MACRO GTK_STOCK_GO_FORWARD ##### -->
429 <inlinegraphic fileref="gtk-go-forward-ltr.png" format="PNG"></inlinegraphic>
431 <inlinegraphic fileref="gtk-go-forward-rtl.png" format="PNG"></inlinegraphic>
436 <!-- ##### MACRO GTK_STOCK_GO_UP ##### -->
439 <inlinegraphic fileref="gtk-go-up.png" format="PNG"></inlinegraphic>
444 <!-- ##### MACRO GTK_STOCK_HARDDISK ##### -->
447 <inlinegraphic fileref="gtk-harddisk.png" format="PNG"></inlinegraphic>
453 <!-- ##### MACRO GTK_STOCK_HELP ##### -->
456 <inlinegraphic fileref="gtk-help.png" format="PNG"></inlinegraphic>
461 <!-- ##### MACRO GTK_STOCK_HOME ##### -->
464 <inlinegraphic fileref="gtk-home.png" format="PNG"></inlinegraphic>
469 <!-- ##### MACRO GTK_STOCK_INDENT ##### -->
472 <inlinegraphic fileref="gtk-indent-ltr.png" format="PNG"></inlinegraphic>
474 <inlinegraphic fileref="gtk-indent-rtl.png" format="PNG"></inlinegraphic>
480 <!-- ##### MACRO GTK_STOCK_INDEX ##### -->
483 <inlinegraphic fileref="gtk-index.png" format="PNG"></inlinegraphic>
488 <!-- ##### MACRO GTK_STOCK_INFO ##### -->
491 <inlinegraphic fileref="gtk-info.png" format="PNG"></inlinegraphic>
497 <!-- ##### MACRO GTK_STOCK_ITALIC ##### -->
500 <inlinegraphic fileref="gtk-italic.png" format="PNG"></inlinegraphic>
505 <!-- ##### MACRO GTK_STOCK_JUMP_TO ##### -->
508 <inlinegraphic fileref="gtk-jump-to-ltr.png" format="PNG"></inlinegraphic>
510 <inlinegraphic fileref="gtk-jump-to-rtl.png" format="PNG"></inlinegraphic>
515 <!-- ##### MACRO GTK_STOCK_JUSTIFY_CENTER ##### -->
518 <inlinegraphic fileref="gtk-justify-center.png" format="PNG"></inlinegraphic>
523 <!-- ##### MACRO GTK_STOCK_JUSTIFY_FILL ##### -->
526 <inlinegraphic fileref="gtk-justify-fill.png" format="PNG"></inlinegraphic>
531 <!-- ##### MACRO GTK_STOCK_JUSTIFY_LEFT ##### -->
534 <inlinegraphic fileref="gtk-justify-left.png" format="PNG"></inlinegraphic>
539 <!-- ##### MACRO GTK_STOCK_JUSTIFY_RIGHT ##### -->
542 <inlinegraphic fileref="gtk-justify-right.png" format="PNG"></inlinegraphic>
547 <!-- ##### MACRO GTK_STOCK_LEAVE_FULLSCREEN ##### -->
549 The "Leave Fullscreen" item.
550 <inlinegraphic fileref="gtk-leave-fullscreen.png" format="PNG"></inlinegraphic>
556 <!-- ##### MACRO GTK_STOCK_MEDIA_FORWARD ##### -->
558 The "Media Forward" item.
559 <inlinegraphic fileref="gtk-media-forward-ltr.png" format="PNG"></inlinegraphic>
561 <inlinegraphic fileref="gtk-media-forward-rtl.png" format="PNG"></inlinegraphic>
567 <!-- ##### MACRO GTK_STOCK_MEDIA_NEXT ##### -->
569 The "Media Next" item.
570 <inlinegraphic fileref="gtk-media-next-ltr.png" format="PNG"></inlinegraphic>
572 <inlinegraphic fileref="gtk-media-next-rtl.png" format="PNG"></inlinegraphic>
578 <!-- ##### MACRO GTK_STOCK_MEDIA_PAUSE ##### -->
580 The "Media Pause" item.
581 <inlinegraphic fileref="gtk-media-pause.png" format="PNG"></inlinegraphic>
587 <!-- ##### MACRO GTK_STOCK_MEDIA_PLAY ##### -->
589 The "Media Play" item.
590 <inlinegraphic fileref="gtk-media-play-ltr.png" format="PNG"></inlinegraphic>
592 <inlinegraphic fileref="gtk-media-play-rtl.png" format="PNG"></inlinegraphic>
598 <!-- ##### MACRO GTK_STOCK_MEDIA_PREVIOUS ##### -->
600 The "Media Previous" item.
601 <inlinegraphic fileref="gtk-media-previous-ltr.png" format="PNG"></inlinegraphic>
603 <inlinegraphic fileref="gtk-media-previous-rtl.png" format="PNG"></inlinegraphic>
609 <!-- ##### MACRO GTK_STOCK_MEDIA_RECORD ##### -->
611 The "Media Record" item.
612 <inlinegraphic fileref="gtk-media-record.png" format="PNG"></inlinegraphic>
618 <!-- ##### MACRO GTK_STOCK_MEDIA_REWIND ##### -->
620 The "Media Rewind" item.
621 <inlinegraphic fileref="gtk-media-rewind-ltr.png" format="PNG"></inlinegraphic>
623 <inlinegraphic fileref="gtk-media-rewind-rtl.png" format="PNG"></inlinegraphic>
629 <!-- ##### MACRO GTK_STOCK_MEDIA_STOP ##### -->
631 The "Media Stop" item.
632 <inlinegraphic fileref="gtk-media-stop.png" format="PNG"></inlinegraphic>
638 <!-- ##### MACRO GTK_STOCK_MISSING_IMAGE ##### -->
640 The "Missing image" icon.
641 <inlinegraphic fileref="gtk-missing-image.png" format="PNG"></inlinegraphic>
646 <!-- ##### MACRO GTK_STOCK_NETWORK ##### -->
649 <inlinegraphic fileref="gtk-network.png" format="PNG"></inlinegraphic>
655 <!-- ##### MACRO GTK_STOCK_NEW ##### -->
658 <inlinegraphic fileref="gtk-new.png" format="PNG"></inlinegraphic>
663 <!-- ##### MACRO GTK_STOCK_NO ##### -->
666 <inlinegraphic fileref="gtk-no.png" format="PNG"></inlinegraphic>
671 <!-- ##### MACRO GTK_STOCK_OK ##### -->
674 <inlinegraphic fileref="gtk-ok.png" format="PNG"></inlinegraphic>
679 <!-- ##### MACRO GTK_STOCK_OPEN ##### -->
682 <inlinegraphic fileref="gtk-open.png" format="PNG"></inlinegraphic>
687 <!-- ##### MACRO GTK_STOCK_ORIENTATION_LANDSCAPE ##### -->
689 The "Landscape Orientation" item.
690 <inlinegraphic fileref="gtk-orientation-landscape.png" format="PNG"></inlinegraphic>
696 <!-- ##### MACRO GTK_STOCK_ORIENTATION_PORTRAIT ##### -->
698 The "Portrait Orientation" item.
699 <inlinegraphic fileref="gtk-orientation-portrait.png" format="PNG"></inlinegraphic>
705 <!-- ##### MACRO GTK_STOCK_ORIENTATION_REVERSE_LANDSCAPE ##### -->
707 The "Reverse Landscape Orientation" item.
708 <inlinegraphic fileref="gtk-orientation-reverse-landscape.png" format="PNG"></inlinegraphic>
714 <!-- ##### MACRO GTK_STOCK_ORIENTATION_REVERSE_PORTRAIT ##### -->
716 The "Reverse Portrait Orientation" item.
717 <inlinegraphic fileref="gtk-orientation-reverse-portrait.png" format="PNG"></inlinegraphic>
723 <!-- ##### MACRO GTK_STOCK_PAGE_SETUP ##### -->
725 The "Page Setup" item.
726 <inlinegraphic fileref="gtk-page-setup.png" format="PNG"></inlinegraphic>
732 <!-- ##### MACRO GTK_STOCK_PASTE ##### -->
735 <inlinegraphic fileref="gtk-paste.png" format="PNG"></inlinegraphic>
740 <!-- ##### MACRO GTK_STOCK_PREFERENCES ##### -->
742 The "Preferences" item.
743 <inlinegraphic fileref="gtk-preferences.png" format="PNG"></inlinegraphic>
748 <!-- ##### MACRO GTK_STOCK_PRINT ##### -->
751 <inlinegraphic fileref="gtk-print.png" format="PNG"></inlinegraphic>
756 <!-- ##### MACRO GTK_STOCK_PRINT_PREVIEW ##### -->
758 The "Print Preview" item.
759 <inlinegraphic fileref="gtk-print-preview.png" format="PNG"></inlinegraphic>
764 <!-- ##### MACRO GTK_STOCK_PROPERTIES ##### -->
766 The "Properties" item.
767 <inlinegraphic fileref="gtk-properties.png" format="PNG"></inlinegraphic>
772 <!-- ##### MACRO GTK_STOCK_QUIT ##### -->
775 <inlinegraphic fileref="gtk-quit.png" format="PNG"></inlinegraphic>
780 <!-- ##### MACRO GTK_STOCK_REDO ##### -->
783 <inlinegraphic fileref="gtk-redo-ltr.png" format="PNG"></inlinegraphic>
785 <inlinegraphic fileref="gtk-redo-rtl.png" format="PNG"></inlinegraphic>
790 <!-- ##### MACRO GTK_STOCK_REFRESH ##### -->
793 <inlinegraphic fileref="gtk-refresh.png" format="PNG"></inlinegraphic>
798 <!-- ##### MACRO GTK_STOCK_REMOVE ##### -->
801 <inlinegraphic fileref="gtk-remove.png" format="PNG"></inlinegraphic>
806 <!-- ##### MACRO GTK_STOCK_REVERT_TO_SAVED ##### -->
809 <inlinegraphic fileref="gtk-revert-to-saved-ltr.png" format="PNG"></inlinegraphic>
811 <inlinegraphic fileref="gtk-revert-to-saved-rtl.png" format="PNG"></inlinegraphic>
816 <!-- ##### MACRO GTK_STOCK_SAVE ##### -->
819 <inlinegraphic fileref="gtk-save.png" format="PNG"></inlinegraphic>
824 <!-- ##### MACRO GTK_STOCK_SAVE_AS ##### -->
827 <inlinegraphic fileref="gtk-save-as.png" format="PNG"></inlinegraphic>
832 <!-- ##### MACRO GTK_STOCK_SELECT_ALL ##### -->
834 The "Select All" item.
835 <inlinegraphic fileref="gtk-select-all.png" format="PNG"></inlinegraphic>
841 <!-- ##### MACRO GTK_STOCK_SELECT_COLOR ##### -->
844 <inlinegraphic fileref="gtk-select-color.png" format="PNG"></inlinegraphic>
849 <!-- ##### MACRO GTK_STOCK_SELECT_FONT ##### -->
852 <inlinegraphic fileref="gtk-font.png" format="PNG"></inlinegraphic>
857 <!-- ##### MACRO GTK_STOCK_SORT_ASCENDING ##### -->
859 The "Ascending" item.
860 <inlinegraphic fileref="gtk-sort-ascending.png" format="PNG"></inlinegraphic>
865 <!-- ##### MACRO GTK_STOCK_SORT_DESCENDING ##### -->
867 The "Descending" item.
868 <inlinegraphic fileref="gtk-sort-descending.png" format="PNG"></inlinegraphic>
873 <!-- ##### MACRO GTK_STOCK_SPELL_CHECK ##### -->
875 The "Spell Check" item.
876 <inlinegraphic fileref="gtk-spell-check.png" format="PNG"></inlinegraphic>
881 <!-- ##### MACRO GTK_STOCK_STOP ##### -->
884 <inlinegraphic fileref="gtk-stop.png" format="PNG"></inlinegraphic>
889 <!-- ##### MACRO GTK_STOCK_STRIKETHROUGH ##### -->
891 The "Strikethrough" item.
892 <inlinegraphic fileref="gtk-strikethrough.png" format="PNG"></inlinegraphic>
897 <!-- ##### MACRO GTK_STOCK_UNDELETE ##### -->
900 <inlinegraphic fileref="gtk-undelete-ltr.png" format="PNG"></inlinegraphic>
902 <inlinegraphic fileref="gtk-undelete-rtl.png" format="PNG"></inlinegraphic>
907 <!-- ##### MACRO GTK_STOCK_UNDERLINE ##### -->
909 The "Underline" item.
910 <inlinegraphic fileref="gtk-underline.png" format="PNG"></inlinegraphic>
915 <!-- ##### MACRO GTK_STOCK_UNDO ##### -->
918 <inlinegraphic fileref="gtk-undo-ltr.png" format="PNG"></inlinegraphic>
920 <inlinegraphic fileref="gtk-undo-rtl.png" format="PNG"></inlinegraphic>
925 <!-- ##### MACRO GTK_STOCK_UNINDENT ##### -->
928 <inlinegraphic fileref="gtk-unindent-ltr.png" format="PNG"></inlinegraphic>
930 <inlinegraphic fileref="gtk-unindent-rtl.png" format="PNG"></inlinegraphic>
936 <!-- ##### MACRO GTK_STOCK_YES ##### -->
939 <inlinegraphic fileref="gtk-yes.png" format="PNG"></inlinegraphic>
944 <!-- ##### MACRO GTK_STOCK_ZOOM_100 ##### -->
946 The "Zoom 100%" item.
947 <inlinegraphic fileref="gtk-zoom-100.png" format="PNG"></inlinegraphic>
952 <!-- ##### MACRO GTK_STOCK_ZOOM_FIT ##### -->
954 The "Zoom to Fit" item.
955 <inlinegraphic fileref="gtk-zoom-fit.png" format="PNG"></inlinegraphic>
960 <!-- ##### MACRO GTK_STOCK_ZOOM_IN ##### -->
963 <inlinegraphic fileref="gtk-zoom-in.png" format="PNG"></inlinegraphic>
968 <!-- ##### MACRO GTK_STOCK_ZOOM_OUT ##### -->
971 <inlinegraphic fileref="gtk-zoom-out.png" format="PNG"></inlinegraphic>