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 <!-- ##### STRUCT GtkStockItem ##### -->
46 <!-- ##### FUNCTION gtk_stock_add ##### -->
55 <!-- ##### FUNCTION gtk_stock_add_static ##### -->
64 <!-- ##### FUNCTION gtk_stock_item_copy ##### -->
73 <!-- ##### FUNCTION gtk_stock_item_free ##### -->
81 <!-- ##### FUNCTION gtk_stock_list_ids ##### -->
89 <!-- ##### FUNCTION gtk_stock_lookup ##### -->
99 <!-- ##### MACRO GTK_STOCK_ABOUT ##### -->
102 <inlinegraphic fileref="stock_about_24.png" format="PNG"></inlinegraphic>
108 <!-- ##### MACRO GTK_STOCK_ADD ##### -->
111 <inlinegraphic fileref="stock_add_24.png" format="PNG"></inlinegraphic>
116 <!-- ##### MACRO GTK_STOCK_APPLY ##### -->
119 <inlinegraphic fileref="stock_apply_20.png" format="PNG"></inlinegraphic>
124 <!-- ##### MACRO GTK_STOCK_BOLD ##### -->
127 <inlinegraphic fileref="stock_text_bold_24.png" format="PNG"></inlinegraphic>
132 <!-- ##### MACRO GTK_STOCK_CANCEL ##### -->
135 <inlinegraphic fileref="stock_cancel_20.png" format="PNG"></inlinegraphic>
140 <!-- ##### MACRO GTK_STOCK_CDROM ##### -->
143 <inlinegraphic fileref="stock_cdrom_24.png" format="PNG"></inlinegraphic>
148 <!-- ##### MACRO GTK_STOCK_CLEAR ##### -->
151 <inlinegraphic fileref="stock_clear_24.png" format="PNG"></inlinegraphic>
156 <!-- ##### MACRO GTK_STOCK_CLOSE ##### -->
159 <inlinegraphic fileref="stock_close_24.png" format="PNG"></inlinegraphic>
164 <!-- ##### MACRO GTK_STOCK_COLOR_PICKER ##### -->
166 The "Color Picker" item.
167 <inlinegraphic fileref="stock_color_picker_25.png" format="PNG"></inlinegraphic>
173 <!-- ##### MACRO GTK_STOCK_CONVERT ##### -->
176 <inlinegraphic fileref="stock_convert_24.png" format="PNG"></inlinegraphic>
181 <!-- ##### MACRO GTK_STOCK_CONNECT ##### -->
184 <inlinegraphic fileref="stock_connect_24.png" format="PNG"></inlinegraphic>
190 <!-- ##### MACRO GTK_STOCK_COPY ##### -->
193 <inlinegraphic fileref="stock_copy_24.png" format="PNG"></inlinegraphic>
198 <!-- ##### MACRO GTK_STOCK_CUT ##### -->
201 <inlinegraphic fileref="stock_cut_24.png" format="PNG"></inlinegraphic>
206 <!-- ##### MACRO GTK_STOCK_DELETE ##### -->
209 <inlinegraphic fileref="stock_trash_24.png" format="PNG"></inlinegraphic>
214 <!-- ##### MACRO GTK_STOCK_DIALOG_AUTHENTICATION ##### -->
216 The "Authentication" item.
217 <inlinegraphic fileref="stock_dialog_authentication_48.png" format="PNG"></inlinegraphic>
223 <!-- ##### MACRO GTK_STOCK_DIALOG_ERROR ##### -->
226 <inlinegraphic fileref="stock_dialog_error_48.png" format="PNG"></inlinegraphic>
231 <!-- ##### MACRO GTK_STOCK_DIALOG_INFO ##### -->
233 The "Information" item.
234 <inlinegraphic fileref="stock_dialog_info_48.png" format="PNG"></inlinegraphic>
239 <!-- ##### MACRO GTK_STOCK_DIALOG_QUESTION ##### -->
242 <inlinegraphic fileref="stock_dialog_question_48.png" format="PNG"></inlinegraphic>
247 <!-- ##### MACRO GTK_STOCK_DIALOG_WARNING ##### -->
250 <inlinegraphic fileref="stock_dialog_warning_48.png" format="PNG"></inlinegraphic>
255 <!-- ##### MACRO GTK_STOCK_DIRECTORY ##### -->
257 The "Directory" icon.
258 <inlinegraphic fileref="stock_directory_24.png" format="PNG"></inlinegraphic>
264 <!-- ##### MACRO GTK_STOCK_DISCONNECT ##### -->
266 The "Disconnect" icon.
267 <inlinegraphic fileref="stock_disconnect_24.png" format="PNG"></inlinegraphic>
273 <!-- ##### MACRO GTK_STOCK_DND ##### -->
275 The "Drag-And-Drop" icon.
276 <inlinegraphic fileref="stock_dnd_32.png" format="PNG"></inlinegraphic>
281 <!-- ##### MACRO GTK_STOCK_DND_MULTIPLE ##### -->
283 The "Drag-And-Drop multiple" icon.
284 <inlinegraphic fileref="stock_dnd_multiple_32.png" format="PNG"></inlinegraphic>
289 <!-- ##### MACRO GTK_STOCK_EDIT ##### -->
292 <inlinegraphic fileref="stock_edit_24.png" format="PNG"></inlinegraphic>
298 <!-- ##### MACRO GTK_STOCK_EXECUTE ##### -->
301 <inlinegraphic fileref="stock_exec_24.png" format="PNG"></inlinegraphic>
306 <!-- ##### MACRO GTK_STOCK_FILE ##### -->
310 <inlinegraphic fileref="stock_file_24.png" format="PNG"></inlinegraphic>
317 <!-- ##### MACRO GTK_STOCK_FIND ##### -->
320 <inlinegraphic fileref="stock_search_24.png" format="PNG"></inlinegraphic>
325 <!-- ##### MACRO GTK_STOCK_FIND_AND_REPLACE ##### -->
327 The "Find and Replace" item.
328 <inlinegraphic fileref="stock_search_replace_24.png" format="PNG"></inlinegraphic>
333 <!-- ##### MACRO GTK_STOCK_FLOPPY ##### -->
336 <inlinegraphic fileref="stock_save_24.png" format="PNG"></inlinegraphic>
341 <!-- ##### MACRO GTK_STOCK_GOTO_BOTTOM ##### -->
344 <inlinegraphic fileref="stock_bottom_24.png" format="PNG"></inlinegraphic>
349 <!-- ##### MACRO GTK_STOCK_GOTO_FIRST ##### -->
352 <inlinegraphic fileref="stock_first_24.png" format="PNG"></inlinegraphic>
354 <inlinegraphic fileref="stock_last_24.png" format="PNG"></inlinegraphic>
359 <!-- ##### MACRO GTK_STOCK_GOTO_LAST ##### -->
362 <inlinegraphic fileref="stock_last_24.png" format="PNG"></inlinegraphic>
364 <inlinegraphic fileref="stock_first_24.png" format="PNG"></inlinegraphic>
369 <!-- ##### MACRO GTK_STOCK_GOTO_TOP ##### -->
372 <inlinegraphic fileref="stock_top_24.png" format="PNG"></inlinegraphic>
377 <!-- ##### MACRO GTK_STOCK_GO_BACK ##### -->
380 <inlinegraphic fileref="stock_left_arrow_24.png" format="PNG"></inlinegraphic>
382 <inlinegraphic fileref="stock_right_arrow_24.png" format="PNG"></inlinegraphic>
387 <!-- ##### MACRO GTK_STOCK_GO_DOWN ##### -->
390 <inlinegraphic fileref="stock_down_arrow_24.png" format="PNG"></inlinegraphic>
395 <!-- ##### MACRO GTK_STOCK_GO_FORWARD ##### -->
398 <inlinegraphic fileref="stock_right_arrow_24.png" format="PNG"></inlinegraphic>
400 <inlinegraphic fileref="stock_left_arrow_24.png" format="PNG"></inlinegraphic>
405 <!-- ##### MACRO GTK_STOCK_GO_UP ##### -->
408 <inlinegraphic fileref="stock_up_arrow_24.png" format="PNG"></inlinegraphic>
413 <!-- ##### MACRO GTK_STOCK_HARDDISK ##### -->
416 <inlinegraphic fileref="stock_harddisk_24.png" format="PNG"></inlinegraphic>
422 <!-- ##### MACRO GTK_STOCK_HELP ##### -->
425 <inlinegraphic fileref="stock_help_24.png" format="PNG"></inlinegraphic>
430 <!-- ##### MACRO GTK_STOCK_HOME ##### -->
433 <inlinegraphic fileref="stock_home_24.png" format="PNG"></inlinegraphic>
438 <!-- ##### MACRO GTK_STOCK_INDENT ##### -->
441 <inlinegraphic fileref="stock_indent_24.png" format="PNG"></inlinegraphic>
447 <!-- ##### MACRO GTK_STOCK_INDEX ##### -->
450 <inlinegraphic fileref="stock_index_24.png" format="PNG"></inlinegraphic>
455 <!-- ##### MACRO GTK_STOCK_ITALIC ##### -->
458 <inlinegraphic fileref="stock_text_italic_24.png" format="PNG"></inlinegraphic>
463 <!-- ##### MACRO GTK_STOCK_JUMP_TO ##### -->
466 <inlinegraphic fileref="stock_jump_to_24.png" format="PNG"></inlinegraphic>
468 <inlinegraphic fileref="stock_jump_to_rtl_24.png" format="PNG"></inlinegraphic>
473 <!-- ##### MACRO GTK_STOCK_JUSTIFY_CENTER ##### -->
476 <inlinegraphic fileref="stock_align_center_24.png" format="PNG"></inlinegraphic>
481 <!-- ##### MACRO GTK_STOCK_JUSTIFY_FILL ##### -->
484 <inlinegraphic fileref="stock_align_justify_24.png" format="PNG"></inlinegraphic>
489 <!-- ##### MACRO GTK_STOCK_JUSTIFY_LEFT ##### -->
492 <inlinegraphic fileref="stock_align_left_24.png" format="PNG"></inlinegraphic>
497 <!-- ##### MACRO GTK_STOCK_JUSTIFY_RIGHT ##### -->
500 <inlinegraphic fileref="stock_align_right_24.png" format="PNG"></inlinegraphic>
505 <!-- ##### MACRO GTK_STOCK_MEDIA_FORWARD ##### -->
507 The "Media Forward" item.
508 <inlinegraphic fileref="stock_media_forward_24.png" format="PNG"></inlinegraphic>
514 <!-- ##### MACRO GTK_STOCK_MEDIA_NEXT ##### -->
516 The "Media Next" item.
517 <inlinegraphic fileref="stock_media_next_24.png" format="PNG"></inlinegraphic>
523 <!-- ##### MACRO GTK_STOCK_MEDIA_PAUSE ##### -->
525 The "Media Pause" item.
526 <inlinegraphic fileref="stock_media_pause_24.png" format="PNG"></inlinegraphic>
532 <!-- ##### MACRO GTK_STOCK_MEDIA_PLAY ##### -->
534 The "Media Play" item.
535 <inlinegraphic fileref="stock_media_play_24.png" format="PNG"></inlinegraphic>
541 <!-- ##### MACRO GTK_STOCK_MEDIA_PREVIOUS ##### -->
543 The "Media Previous" item.
544 <inlinegraphic fileref="stock_media_previous_24.png" format="PNG"></inlinegraphic>
550 <!-- ##### MACRO GTK_STOCK_MEDIA_RECORD ##### -->
552 The "Media Record" item.
553 <inlinegraphic fileref="stock_media_record_24.png" format="PNG"></inlinegraphic>
559 <!-- ##### MACRO GTK_STOCK_MEDIA_REWIND ##### -->
561 The "Media Rewind" item.
562 <inlinegraphic fileref="stock_media_rewind_24.png" format="PNG"></inlinegraphic>
568 <!-- ##### MACRO GTK_STOCK_MEDIA_STOP ##### -->
570 The "Media Stop" item.
571 <inlinegraphic fileref="stock_media_stop_24.png" format="PNG"></inlinegraphic>
577 <!-- ##### MACRO GTK_STOCK_MISSING_IMAGE ##### -->
579 The "Missing image" icon.
580 <inlinegraphic fileref="stock_broken_image_24.png" format="PNG"></inlinegraphic>
585 <!-- ##### MACRO GTK_STOCK_NETWORK ##### -->
588 <inlinegraphic fileref="stock_network_24.png" format="PNG"></inlinegraphic>
594 <!-- ##### MACRO GTK_STOCK_NEW ##### -->
597 <inlinegraphic fileref="stock_new_24.png" format="PNG"></inlinegraphic>
602 <!-- ##### MACRO GTK_STOCK_NO ##### -->
605 <inlinegraphic fileref="stock_no_20.png" format="PNG"></inlinegraphic>
610 <!-- ##### MACRO GTK_STOCK_OK ##### -->
613 <inlinegraphic fileref="stock_ok_20.png" format="PNG"></inlinegraphic>
618 <!-- ##### MACRO GTK_STOCK_OPEN ##### -->
621 <inlinegraphic fileref="stock_open_24.png" format="PNG"></inlinegraphic>
626 <!-- ##### MACRO GTK_STOCK_PASTE ##### -->
629 <inlinegraphic fileref="stock_paste_24.png" format="PNG"></inlinegraphic>
634 <!-- ##### MACRO GTK_STOCK_PREFERENCES ##### -->
636 The "Preferences" item.
637 <inlinegraphic fileref="stock_preferences_24.png" format="PNG"></inlinegraphic>
642 <!-- ##### MACRO GTK_STOCK_PRINT ##### -->
645 <inlinegraphic fileref="stock_print_24.png" format="PNG"></inlinegraphic>
650 <!-- ##### MACRO GTK_STOCK_PRINT_PREVIEW ##### -->
652 The "Print Preview" item.
653 <inlinegraphic fileref="stock_print_preview_24.png" format="PNG"></inlinegraphic>
658 <!-- ##### MACRO GTK_STOCK_PROPERTIES ##### -->
660 The "Properties" item.
661 <inlinegraphic fileref="stock_properties_24.png" format="PNG"></inlinegraphic>
666 <!-- ##### MACRO GTK_STOCK_QUIT ##### -->
669 <inlinegraphic fileref="stock_exit_24.png" format="PNG"></inlinegraphic>
674 <!-- ##### MACRO GTK_STOCK_REDO ##### -->
677 <inlinegraphic fileref="stock_redo_24.png" format="PNG"></inlinegraphic>
679 <inlinegraphic fileref="stock_redo_rtl_24.png" format="PNG"></inlinegraphic>
684 <!-- ##### MACRO GTK_STOCK_REFRESH ##### -->
687 <inlinegraphic fileref="stock_refresh_24.png" format="PNG"></inlinegraphic>
692 <!-- ##### MACRO GTK_STOCK_REMOVE ##### -->
695 <inlinegraphic fileref="stock_remove_24.png" format="PNG"></inlinegraphic>
700 <!-- ##### MACRO GTK_STOCK_REVERT_TO_SAVED ##### -->
703 <inlinegraphic fileref="stock_revert_24.png" format="PNG"></inlinegraphic>
705 <inlinegraphic fileref="stock_revert_rtl_24.png" format="PNG"></inlinegraphic>
710 <!-- ##### MACRO GTK_STOCK_SAVE ##### -->
713 <inlinegraphic fileref="stock_save_24.png" format="PNG"></inlinegraphic>
718 <!-- ##### MACRO GTK_STOCK_SAVE_AS ##### -->
721 <inlinegraphic fileref="stock_save_as_24.png" format="PNG"></inlinegraphic>
726 <!-- ##### MACRO GTK_STOCK_SELECT_COLOR ##### -->
729 <inlinegraphic fileref="stock_colorselector_24.png" format="PNG"></inlinegraphic>
734 <!-- ##### MACRO GTK_STOCK_SELECT_FONT ##### -->
737 <inlinegraphic fileref="stock_font_24.png" format="PNG"></inlinegraphic>
742 <!-- ##### MACRO GTK_STOCK_SORT_ASCENDING ##### -->
744 The "Ascending" item.
745 <inlinegraphic fileref="stock_sort_ascending_24.png" format="PNG"></inlinegraphic>
750 <!-- ##### MACRO GTK_STOCK_SORT_DESCENDING ##### -->
752 The "Descending" item.
753 <inlinegraphic fileref="stock_sort_descending_24.png" format="PNG"></inlinegraphic>
758 <!-- ##### MACRO GTK_STOCK_SPELL_CHECK ##### -->
760 The "Spell Check" item.
761 <inlinegraphic fileref="stock_spellcheck_24.png" format="PNG"></inlinegraphic>
766 <!-- ##### MACRO GTK_STOCK_STOP ##### -->
769 <inlinegraphic fileref="stock_stop_24.png" format="PNG"></inlinegraphic>
774 <!-- ##### MACRO GTK_STOCK_STRIKETHROUGH ##### -->
776 The "Strikethrough" item.
777 <inlinegraphic fileref="stock_text_strikethrough_24.png" format="PNG"></inlinegraphic>
782 <!-- ##### MACRO GTK_STOCK_UNDELETE ##### -->
785 <inlinegraphic fileref="stock_undelete_24.png" format="PNG"></inlinegraphic>
787 <inlinegraphic fileref="stock_undelete_rtl_24.png" format="PNG"></inlinegraphic>
792 <!-- ##### MACRO GTK_STOCK_UNDERLINE ##### -->
794 The "Underline" item.
795 <inlinegraphic fileref="stock_text_underline_24.png" format="PNG"></inlinegraphic>
800 <!-- ##### MACRO GTK_STOCK_UNDO ##### -->
803 <inlinegraphic fileref="stock_undo_24.png" format="PNG"></inlinegraphic>
805 <inlinegraphic fileref="stock_undo_rtl_24.png" format="PNG"></inlinegraphic>
810 <!-- ##### MACRO GTK_STOCK_UNINDENT ##### -->
813 <inlinegraphic fileref="stock_unindent_24.png" format="PNG"></inlinegraphic>
819 <!-- ##### MACRO GTK_STOCK_YES ##### -->
822 <inlinegraphic fileref="stock_yes_20.png" format="PNG"></inlinegraphic>
827 <!-- ##### MACRO GTK_STOCK_ZOOM_100 ##### -->
829 The "Zoom 100%" item.
830 <inlinegraphic fileref="stock_zoom_1_24.png" format="PNG"></inlinegraphic>
835 <!-- ##### MACRO GTK_STOCK_ZOOM_FIT ##### -->
837 The "Zoom to Fit" item.
838 <inlinegraphic fileref="stock_zoom_fit_24.png" format="PNG"></inlinegraphic>
843 <!-- ##### MACRO GTK_STOCK_ZOOM_IN ##### -->
846 <inlinegraphic fileref="stock_zoom_in_24.png" format="PNG"></inlinegraphic>
851 <!-- ##### MACRO GTK_STOCK_ZOOM_OUT ##### -->
854 <inlinegraphic fileref="stock_zoom_out_24.png" format="PNG"></inlinegraphic>