📄 gtk-stock-items.html
字号:
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"><html><head><meta http-equiv="Content-Type" content="text/html; charset=US-ASCII"><title>Stock Items</title><meta name="generator" content="DocBook XSL Stylesheets V1.73.2"><link rel="start" href="index.html" title="GTK+ Reference Manual"><link rel="up" href="gtkbase.html" title="Part II. GTK+ Core Reference"><link rel="prev" href="GtkIconTheme.html" title="GtkIconTheme"><link rel="next" href="gtk-Themeable-Stock-Images.html" title="Themeable Stock Images"><meta name="generator" content="GTK-Doc V1.9 (XML mode)"><link rel="stylesheet" href="style.css" type="text/css"><link rel="part" href="gtk.html" title="Part I. GTK+ Overview"><link rel="part" href="gtkbase.html" title="Part II. GTK+ Core Reference"><link rel="part" href="gtkobjects.html" title="Part III. GTK+ Widgets and Objects"><link rel="chapter" href="ch01.html" title="Object Hierarchy"><link rel="chapter" href="ch02.html" title="Widget Gallery"><link rel="chapter" href="WindowWidgets.html" title="Windows"><link rel="chapter" href="DisplayWidgets.html" title="Display Widgets"><link rel="chapter" href="ButtonWidgets.html" title="Buttons and Toggles"><link rel="chapter" href="NumericEntry.html" title="Numeric/Text Data Entry"><link rel="chapter" href="TextWidgetObjects.html" title="Multiline Text Editor"><link rel="chapter" href="TreeWidgetObjects.html" title="Tree, List and Icon Grid Widgets"><link rel="chapter" href="MenusAndCombos.html" title="Menus, Combo Box, Toolbar"><link rel="chapter" href="Actions.html" title="Action-based menus and toolbars"><link rel="chapter" href="SelectorWidgets.html" title="Selectors (File/Font/Color/Input Devices)"><link rel="chapter" href="LayoutContainers.html" title="Layout Containers"><link rel="chapter" href="Ornaments.html" title="Ornaments"><link rel="chapter" href="ScrollingWidgets.html" title="Scrolling"><link rel="chapter" href="Printing.html" title="Printing"><link rel="chapter" href="MiscObjects.html" title="Miscellaneous"><link rel="chapter" href="AbstractObjects.html" title="Abstract Base Classes"><link rel="chapter" href="PlugSocket.html" title="Cross-process Embedding"><link rel="chapter" href="SpecialObjects.html" title="Special-purpose features"><link rel="chapter" href="RecentDocuments.html" title="Recently Used Documents"><link rel="chapter" href="Builder.html" title="Interface builder"><link rel="chapter" href="DeprecatedObjects.html" title="Deprecated"><link rel="part" href="migrating.html" title="Part IV. Migrating from Previous Versions of GTK+"><link rel="chapter" href="gtk-migrating-checklist.html" title="Migration Checklist"><link rel="chapter" href="gtk-migrating-GtkFileChooser.html" title="Migrating from GtkFileSelection to GtkFileChooser"><link rel="chapter" href="gtk-migrating-GtkAction.html" title="Migrating from old menu and toolbar systems to GtkAction"><link rel="chapter" href="gtk-migrating-GtkComboBox.html" title="Migrating from GtkOptionMenu and GtkCombo to GtkComboBox and GtkComboBoxEntry"><link rel="chapter" href="gtk-migrating-GtkIconView.html" title="Migrating from GnomeIconList to GtkIconView"><link rel="chapter" href="gtk-migrating-GtkAboutDialog.html" title="Migrating from GnomeAbout to GtkAboutDialog"><link rel="chapter" href="gtk-migrating-GtkColorButton.html" title="Migrating from GnomeColorPicker to GtkColorButton"><link rel="chapter" href="gtk-migrating-GtkAssistant.html" title="Migrating from GnomeDruid to GtkAssistant"><link rel="chapter" href="gtk-migrating-GtkRecentChooser.html" title="Migrating from EggRecent to GtkRecentChooser"><link rel="chapter" href="gtk-migrating-GtkLinkButton.html" title="Migrating from GnomeHRef to GtkLinkButton"><link rel="chapter" href="gtk-migrating-GtkBuilder.html" title="Migrating from libglade to GtkBuilder"><link rel="chapter" href="gtk-migrating-tooltips.html" title="Migrating from GtkTooltips to GtkTooltip"><link rel="part" href="pt05.html" title="Part V. GTK+ Tools"><link rel="glossary" href="glossary.html" title="Glossary"><link rel="index" href="ix01.html" title="Index"><link rel="index" href="ix02.html" title="Index of deprecated symbols"><link rel="index" href="ix03.html" title="Index of new symbols in 2.2"><link rel="index" href="ix04.html" title="Index of new symbols in 2.4"><link rel="index" href="ix05.html" title="Index of new symbols in 2.6"><link rel="index" href="ix06.html" title="Index of new symbols in 2.8"><link rel="index" href="ix07.html" title="Index of new symbols in 2.10"><link rel="index" href="ix08.html" title="Index of new symbols in 2.12"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle"><td><a accesskey="p" href="GtkIconTheme.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td><td><a accesskey="u" href="gtkbase.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td><td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td><th width="100%" align="center">GTK+ Reference Manual</th><td><a accesskey="n" href="gtk-Themeable-Stock-Images.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td></tr><tr><td colspan="5" class="shortcuts"><nobr><a href="#id3208400" class="shortcut">Top</a>  |  <a href="#id3209545" class="shortcut">Description</a></nobr></td></tr></table><div class="refentry" lang="en"><a name="gtk-Stock-Items"></a><div class="titlepage"></div><div class="refnamediv"><table width="100%"><tr><td valign="top"><h2><a name="id3208400"></a><span class="refentrytitle">Stock Items</span></h2><p>Stock Items — Prebuilt common menu/toolbar items and corresponding icons</p></td><td valign="top" align="right"></td></tr></table></div><div class="refsynopsisdiv"><h2>Synopsis</h2><pre class="synopsis">#include <gtk/gtk.h> <a class="link" href="gtk-Stock-Items.html#GtkStockItem">GtkStockItem</a>;void <a class="link" href="gtk-Stock-Items.html#gtk-stock-add">gtk_stock_add</a> (const <a class="link" href="gtk-Stock-Items.html#GtkStockItem">GtkStockItem</a> *items, <ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint">guint</a> n_items);void <a class="link" href="gtk-Stock-Items.html#gtk-stock-add-static">gtk_stock_add_static</a> (const <a class="link" href="gtk-Stock-Items.html#GtkStockItem">GtkStockItem</a> *items, <ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint">guint</a> n_items);<a class="link" href="gtk-Stock-Items.html#GtkStockItem">GtkStockItem</a>* <a class="link" href="gtk-Stock-Items.html#gtk-stock-item-copy">gtk_stock_item_copy</a> (const <a class="link" href="gtk-Stock-Items.html#GtkStockItem">GtkStockItem</a> *item);void <a class="link" href="gtk-Stock-Items.html#gtk-stock-item-free">gtk_stock_item_free</a> (<a class="link" href="gtk-Stock-Items.html#GtkStockItem">GtkStockItem</a> *item);<ahref="/usr/share/gtk-doc/html/glib/glib-Singly-Linked-Lists.html#GSList">GSList</a>* <a class="link" href="gtk-Stock-Items.html#gtk-stock-list-ids">gtk_stock_list_ids</a> (void);<ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean">gboolean</a> <a class="link" href="gtk-Stock-Items.html#gtk-stock-lookup">gtk_stock_lookup</a> (const <ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> *stock_id, <a class="link" href="gtk-Stock-Items.html#GtkStockItem">GtkStockItem</a> *item);void <a class="link" href="gtk-Stock-Items.html#gtk-stock-set-translate-func">gtk_stock_set_translate_func</a> (const <ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> *domain, <a class="link" href="GtkItemFactory.html#GtkTranslateFunc">GtkTranslateFunc</a> func, <ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer">gpointer</a> data, <a class="link" href="gtk-Types.html#GtkDestroyNotify">GtkDestroyNotify</a> notify);#define <a class="link" href="gtk-Stock-Items.html#GTK-STOCK-ABOUT:CAPS">GTK_STOCK_ABOUT</a>#define <a class="link" href="gtk-Stock-Items.html#GTK-STOCK-ADD:CAPS">GTK_STOCK_ADD</a>#define <a class="link" href="gtk-Stock-Items.html#GTK-STOCK-APPLY:CAPS">GTK_STOCK_APPLY</a>#define <a class="link" href="gtk-Stock-Items.html#GTK-STOCK-BOLD:CAPS">GTK_STOCK_BOLD</a>#define <a class="link" href="gtk-Stock-Items.html#GTK-STOCK-CANCEL:CAPS">GTK_STOCK_CANCEL</a>#define <a class="link" href="gtk-Stock-Items.html#GTK-STOCK-CDROM:CAPS">GTK_STOCK_CDROM</a>#define <a class="link" href="gtk-Stock-Items.html#GTK-STOCK-CLEAR:CAPS">GTK_STOCK_CLEAR</a>#define <a class="link" href="gtk-Stock-Items.html#GTK-STOCK-CLOSE:CAPS">GTK_STOCK_CLOSE</a>#define <a class="link" href="gtk-Stock-Items.html#GTK-STOCK-COLOR-PICKER:CAPS">GTK_STOCK_COLOR_PICKER</a>#define <a class="link" href="gtk-Stock-Items.html#GTK-STOCK-CONVERT:CAPS">GTK_STOCK_CONVERT</a>#define <a class="link" href="gtk-Stock-Items.html#GTK-STOCK-CONNECT:CAPS">GTK_STOCK_CONNECT</a>#define <a class="link" href="gtk-Stock-Items.html#GTK-STOCK-COPY:CAPS">GTK_STOCK_COPY</a>#define <a class="link" href="gtk-Stock-Items.html#GTK-STOCK-CUT:CAPS">GTK_STOCK_CUT</a>#define <a class="link" href="gtk-Stock-Items.html#GTK-STOCK-DELETE:CAPS">GTK_STOCK_DELETE</a>#define <a class="link" href="gtk-Stock-Items.html#GTK-STOCK-DIALOG-AUTHENTICATION:CAPS">GTK_STOCK_DIALOG_AUTHENTICATION</a>#define <a class="link" href="gtk-Stock-Items.html#GTK-STOCK-DIALOG-ERROR:CAPS">GTK_STOCK_DIALOG_ERROR</a>#define <a class="link" href="gtk-Stock-Items.html#GTK-STOCK-DIALOG-INFO:CAPS">GTK_STOCK_DIALOG_INFO</a>#define <a class="link" href="gtk-Stock-Items.html#GTK-STOCK-DIALOG-QUESTION:CAPS">GTK_STOCK_DIALOG_QUESTION</a>#define <a class="link" href="gtk-Stock-Items.html#GTK-STOCK-DIALOG-WARNING:CAPS">GTK_STOCK_DIALOG_WARNING</a>#define <a class="link" href="gtk-Stock-Items.html#GTK-STOCK-DIRECTORY:CAPS">GTK_STOCK_DIRECTORY</a>#define <a class="link" href="gtk-Stock-Items.html#GTK-STOCK-DISCARD:CAPS">GTK_STOCK_DISCARD</a>#define <a class="link" href="gtk-Stock-Items.html#GTK-STOCK-DISCONNECT:CAPS">GTK_STOCK_DISCONNECT</a>#define <a class="link" href="gtk-Stock-Items.html#GTK-STOCK-DND:CAPS">GTK_STOCK_DND</a>#define <a class="link" href="gtk-Stock-Items.html#GTK-STOCK-DND-MULTIPLE:CAPS">GTK_STOCK_DND_MULTIPLE</a>#define <a class="link" href="gtk-Stock-Items.html#GTK-STOCK-EDIT:CAPS">GTK_STOCK_EDIT</a>#define <a class="link" href="gtk-Stock-Items.html#GTK-STOCK-EXECUTE:CAPS">GTK_STOCK_EXECUTE</a>#define <a class="link" href="gtk-Stock-Items.html#GTK-STOCK-FILE:CAPS">GTK_STOCK_FILE</a>#define <a class="link" href="gtk-Stock-Items.html#GTK-STOCK-FIND:CAPS">GTK_STOCK_FIND</a>#define <a class="link" href="gtk-Stock-Items.html#GTK-STOCK-FIND-AND-REPLACE:CAPS">GTK_STOCK_FIND_AND_REPLACE</a>#define <a class="link" href="gtk-Stock-Items.html#GTK-STOCK-FLOPPY:CAPS">GTK_STOCK_FLOPPY</a>#define <a class="link" href="gtk-Stock-Items.html#GTK-STOCK-FULLSCREEN:CAPS">GTK_STOCK_FULLSCREEN</a>#define <a class="link" href="gtk-Stock-Items.html#GTK-STOCK-GOTO-BOTTOM:CAPS">GTK_STOCK_GOTO_BOTTOM</a>#define <a class="link" href="gtk-Stock-Items.html#GTK-STOCK-GOTO-FIRST:CAPS">GTK_STOCK_GOTO_FIRST</a>#define <a class="link" href="gtk-Stock-Items.html#GTK-STOCK-GOTO-LAST:CAPS">GTK_STOCK_GOTO_LAST</a>#define <a class="link" href="gtk-Stock-Items.html#GTK-STOCK-GOTO-TOP:CAPS">GTK_STOCK_GOTO_TOP</a>#define <a class="link" href="gtk-Stock-Items.html#GTK-STOCK-GO-BACK:CAPS">GTK_STOCK_GO_BACK</a>#define <a class="link" href="gtk-Stock-Items.html#GTK-STOCK-GO-DOWN:CAPS">GTK_STOCK_GO_DOWN</a>#define <a class="link" href="gtk-Stock-Items.html#GTK-STOCK-GO-FORWARD:CAPS">GTK_STOCK_GO_FORWARD</a>#define <a class="link" href="gtk-Stock-Items.html#GTK-STOCK-GO-UP:CAPS">GTK_STOCK_GO_UP</a>#define <a class="link" href="gtk-Stock-Items.html#GTK-STOCK-HARDDISK:CAPS">GTK_STOCK_HARDDISK</a>#define <a class="link" href="gtk-Stock-Items.html#GTK-STOCK-HELP:CAPS">GTK_STOCK_HELP</a>#define <a class="link" href="gtk-Stock-Items.html#GTK-STOCK-HOME:CAPS">GTK_STOCK_HOME</a>#define <a class="link" href="gtk-Stock-Items.html#GTK-STOCK-INDENT:CAPS">GTK_STOCK_INDENT</a>#define <a class="link" href="gtk-Stock-Items.html#GTK-STOCK-INDEX:CAPS">GTK_STOCK_INDEX</a>#define <a class="link" href="gtk-Stock-Items.html#GTK-STOCK-INFO:CAPS">GTK_STOCK_INFO</a>#define <a class="link" href="gtk-Stock-Items.html#GTK-STOCK-ITALIC:CAPS">GTK_STOCK_ITALIC</a>#define <a class="link" href="gtk-Stock-Items.html#GTK-STOCK-JUMP-TO:CAPS">GTK_STOCK_JUMP_TO</a>#define <a class="link" href="gtk-Stock-Items.html#GTK-STOCK-JUSTIFY-CENTER:CAPS">GTK_STOCK_JUSTIFY_CENTER</a>#define <a class="link" href="gtk-Stock-Items.html#GTK-STOCK-JUSTIFY-FILL:CAPS">GTK_STOCK_JUSTIFY_FILL</a>#define <a class="link" href="gtk-Stock-Items.html#GTK-STOCK-JUSTIFY-LEFT:CAPS">GTK_STOCK_JUSTIFY_LEFT</a>#define <a class="link" href="gtk-Stock-Items.html#GTK-STOCK-JUSTIFY-RIGHT:CAPS">GTK_STOCK_JUSTIFY_RIGHT</a>#define <a class="link" href="gtk-Stock-Items.html#GTK-STOCK-LEAVE-FULLSCREEN:CAPS">GTK_STOCK_LEAVE_FULLSCREEN</a>#define <a class="link" href="gtk-Stock-Items.html#GTK-STOCK-MEDIA-FORWARD:CAPS">GTK_STOCK_MEDIA_FORWARD</a>#define <a class="link" href="gtk-Stock-Items.html#GTK-STOCK-MEDIA-NEXT:CAPS">GTK_STOCK_MEDIA_NEXT</a>#define <a class="link" href="gtk-Stock-Items.html#GTK-STOCK-MEDIA-PAUSE:CAPS">GTK_STOCK_MEDIA_PAUSE</a>#define <a class="link" href="gtk-Stock-Items.html#GTK-STOCK-MEDIA-PLAY:CAPS">GTK_STOCK_MEDIA_PLAY</a>#define <a class="link" href="gtk-Stock-Items.html#GTK-STOCK-MEDIA-PREVIOUS:CAPS">GTK_STOCK_MEDIA_PREVIOUS</a>#define <a class="link" href="gtk-Stock-Items.html#GTK-STOCK-MEDIA-RECORD:CAPS">GTK_STOCK_MEDIA_RECORD</a>#define <a class="link" href="gtk-Stock-Items.html#GTK-STOCK-MEDIA-REWIND:CAPS">GTK_STOCK_MEDIA_REWIND</a>#define <a class="link" href="gtk-Stock-Items.html#GTK-STOCK-MEDIA-STOP:CAPS">GTK_STOCK_MEDIA_STOP</a>#define <a class="link" href="gtk-Stock-Items.html#GTK-STOCK-MISSING-IMAGE:CAPS">GTK_STOCK_MISSING_IMAGE</a>#define <a class="link" href="gtk-Stock-Items.html#GTK-STOCK-NETWORK:CAPS">GTK_STOCK_NETWORK</a>#define <a class="link" href="gtk-Stock-Items.html#GTK-STOCK-NEW:CAPS">GTK_STOCK_NEW</a>#define <a class="link" href="gtk-Stock-Items.html#GTK-STOCK-NO:CAPS">GTK_STOCK_NO</a>#define <a class="link" href="gtk-Stock-Items.html#GTK-STOCK-OK:CAPS">GTK_STOCK_OK</a>#define <a class="link" href="gtk-Stock-Items.html#GTK-STOCK-OPEN:CAPS">GTK_STOCK_OPEN</a>#define <a class="link" href="gtk-Stock-Items.html#GTK-STOCK-ORIENTATION-LANDSCAPE:CAPS">GTK_STOCK_ORIENTATION_LANDSCAPE</a>#define <a class="link" href="gtk-Stock-Items.html#GTK-STOCK-ORIENTATION-PORTRAIT:CAPS">GTK_STOCK_ORIENTATION_PORTRAIT</a>#define <a class="link" href="gtk-Stock-Items.html#GTK-STOCK-ORIENTATION-REVERSE-LANDSCAPE:CAPS">GTK_STOCK_ORIENTATION_REVERSE_LANDSCAPE</a>#define <a class="link" href="gtk-Stock-Items.html#GTK-STOCK-ORIENTATION-REVERSE-PORTRAIT:CAPS">GTK_STOCK_ORIENTATION_REVERSE_PORTRAIT</a>#define <a class="link" href="gtk-Stock-Items.html#GTK-STOCK-PASTE:CAPS">GTK_STOCK_PASTE</a>#define <a class="link" href="gtk-Stock-Items.html#GTK-STOCK-PREFERENCES:CAPS">GTK_STOCK_PREFERENCES</a>#define <a class="link" href="gtk-Stock-Items.html#GTK-STOCK-PRINT:CAPS">GTK_STOCK_PRINT</a>#define <a class="link" href="gtk-Stock-Items.html#GTK-STOCK-PRINT-PREVIEW:CAPS">GTK_STOCK_PRINT_PREVIEW</a>#define <a class="link" href="gtk-Stock-Items.html#GTK-STOCK-PROPERTIES:CAPS">GTK_STOCK_PROPERTIES</a>#define <a class="link" href="gtk-Stock-Items.html#GTK-STOCK-QUIT:CAPS">GTK_STOCK_QUIT</a>#define <a class="link" href="gtk-Stock-Items.html#GTK-STOCK-REDO:CAPS">GTK_STOCK_REDO</a>#define <a class="link" href="gtk-Stock-Items.html#GTK-STOCK-REFRESH:CAPS">GTK_STOCK_REFRESH</a>#define <a class="link" href="gtk-Stock-Items.html#GTK-STOCK-REMOVE:CAPS">GTK_STOCK_REMOVE</a>#define <a class="link" href="gtk-Stock-Items.html#GTK-STOCK-REVERT-TO-SAVED:CAPS">GTK_STOCK_REVERT_TO_SAVED</a>#define <a class="link" href="gtk-Stock-Items.html#GTK-STOCK-SAVE:CAPS">GTK_STOCK_SAVE</a>#define <a class="link" href="gtk-Stock-Items.html#GTK-STOCK-SAVE-AS:CAPS">GTK_STOCK_SAVE_AS</a>#define <a class="link" href="gtk-Stock-Items.html#GTK-STOCK-SELECT-ALL:CAPS">GTK_STOCK_SELECT_ALL</a>#define <a class="link" href="gtk-Stock-Items.html#GTK-STOCK-SELECT-COLOR:CAPS">GTK_STOCK_SELECT_COLOR</a>#define <a class="link" href="gtk-Stock-Items.html#GTK-STOCK-SELECT-FONT:CAPS">GTK_STOCK_SELECT_FONT</a>#define <a class="link" href="gtk-Stock-Items.html#GTK-STOCK-SORT-ASCENDING:CAPS">GTK_STOCK_SORT_ASCENDING</a>#define <a class="link" href="gtk-Stock-Items.html#GTK-STOCK-SORT-DESCENDING:CAPS">GTK_STOCK_SORT_DESCENDING</a>#define <a class="link" href="gtk-Stock-Items.html#GTK-STOCK-SPELL-CHECK:CAPS">GTK_STOCK_SPELL_CHECK</a>#define <a class="link" href="gtk-Stock-Items.html#GTK-STOCK-STOP:CAPS">GTK_STOCK_STOP</a>#define <a class="link" href="gtk-Stock-Items.html#GTK-STOCK-STRIKETHROUGH:CAPS">GTK_STOCK_STRIKETHROUGH</a>#define <a class="link" href="gtk-Stock-Items.html#GTK-STOCK-UNDELETE:CAPS">GTK_STOCK_UNDELETE</a>#define <a class="link" href="gtk-Stock-Items.html#GTK-STOCK-UNDERLINE:CAPS">GTK_STOCK_UNDERLINE</a>#define <a class="link" href="gtk-Stock-Items.html#GTK-STOCK-UNDO:CAPS">GTK_STOCK_UNDO</a>#define <a class="link" href="gtk-Stock-Items.html#GTK-STOCK-UNINDENT:CAPS">GTK_STOCK_UNINDENT</a>#define <a class="link" href="gtk-Stock-Items.html#GTK-STOCK-YES:CAPS">GTK_STOCK_YES</a>#define <a class="link" href="gtk-Stock-Items.html#GTK-STOCK-ZOOM-100:CAPS">GTK_STOCK_ZOOM_100</a>#define <a class="link" href="gtk-Stock-Items.html#GTK-STOCK-ZOOM-FIT:CAPS">GTK_STOCK_ZOOM_FIT</a>#define <a class="link" href="gtk-Stock-Items.html#GTK-STOCK-ZOOM-IN:CAPS">GTK_STOCK_ZOOM_IN</a>#define <a class="link" href="gtk-Stock-Items.html#GTK-STOCK-ZOOM-OUT:CAPS">GTK_STOCK_ZOOM_OUT</a></pre></div><div class="refsect1" lang="en"><a name="id3209545"></a><h2>Description</h2><p>Stock items represent commonly-used menu or toolbar items such as"Open" or "Exit". Each stock item is identified by a stock ID; stock IDs are just strings, but macros such as <a class="link" href="gtk-Stock-Items.html#GTK-STOCK-OPEN:CAPS"><span class="type">GTK_STOCK_OPEN</span></a> areprovided to avoid typing mistakes in the strings.Applications can register their own stock items in addition to thosebuilt-in to GTK+.</p><p>Each stock ID can be associated with a <a class="link" href="gtk-Stock-Items.html#GtkStockItem"><span class="type">GtkStockItem</span></a>, which containsthe user-visible label, keyboard accelerator, and translation domainof the menu or toolbar item; and/or with an icon stored in a<a class="link" href="gtk-Themeable-Stock-Images.html#GtkIconFactory"><span class="type">GtkIconFactory</span></a>. See <a class="link" href="gtk-Themeable-Stock-Images.html" title="Themeable Stock Images">GtkIconFactory</a> formore information on stock icons. The connection between a<a class="link" href="gtk-Stock-Items.html#GtkStockItem"><span class="type">GtkStockItem</span></a> and stock icons is purely conventional (by virtue ofusing the same stock ID); it's possible to register a stock item butno icon, and vice versa. Stock icons may have a RTL variant which getsused for right-to-left locales. </p></div><div class="refsect1" lang="en"><a name="id3209618"></a><h2>Details</h2><div class="refsect2" lang="en"><a name="id3209628"></a><h3><a name="GtkStockItem"></a>GtkStockItem</h3><a class="indexterm" name="id3209640"></a><pre class="programlisting">typedef struct { gchar *stock_id; gchar *label; GdkModifierType modifier; guint keyval; gchar *translation_domain;} GtkStockItem;</pre><p></p></div><hr><div class="refsect2" lang="en"><a name="id3209657"></a><h3><a name="gtk-stock-add"></a>gtk_stock_add ()</h3><a class="indexterm" name="id3209670"></a><pre class="programlisting">void gtk_stock_add (const <a class="link" href="gtk-Stock-Items.html#GtkStockItem">GtkStockItem</a> *items, <ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint">guint</a> n_items);</pre><p>Registers each of the stock items in <em class="parameter"><code>items</code></em>. If an item alreadyexists with the same stock ID as one of the <em class="parameter"><code>items</code></em>, the old itemgets replaced. The stock items are copied, so GTK+ does not holdany pointer into <em class="parameter"><code>items</code></em> and <em class="parameter"><code>items</code></em> can be freed. Use<a class="link" href="gtk-Stock-Items.html#gtk-stock-add-static"><code class="function">gtk_stock_add_static()</code></a> if <em class="parameter"><code>items</code></em> is persistent and GTK+ need notcopy the array.</p><p></p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><p><span class="term"><em class="parameter"><code>items</code></em> :</span></p></td><td> a <a class="link" href="gtk-Stock-Items.html#GtkStockItem"><span class="type">GtkStockItem</span></a> or array of items</td></tr><tr><td><p><span class="term"><em class="parameter"><code>n_items</code></em> :</span></p></td><td> number of <a class="link" href="gtk-Stock-Items.html#GtkStockItem"><span class="type">GtkStockItem</span></a> in <em class="parameter"><code>items</code></em></td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id3209809"></a><h3><a name="gtk-stock-add-static"></a>gtk_stock_add_static ()</h3><a class="indexterm" name="id3209822"></a><pre class="programlisting">void gtk_stock_add_static (const <a class="link" href="gtk-Stock-Items.html#GtkStockItem">GtkStockItem</a> *items, <ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint">guint</a> n_items);</pre><p>Same as <a class="link" href="gtk-Stock-Items.html#gtk-stock-add"><code class="function">gtk_stock_add()</code></a>, but doesn't copy <em class="parameter"><code>items</code></em>, so<em class="parameter"><code>items</code></em> must persist until application exit.</p><p></p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><p><span class="term"><em class="parameter"><code>items</code></em> :</span></p></td><td> a <a class="link" href="gtk-Stock-Items.html#GtkStockItem"><span class="type">GtkStockItem</span></a> or array of <a class="link" href="gtk-Stock-Items.html#GtkStockItem"><span class="type">GtkStockItem</span></a></td></tr><tr><td><p><span class="term"><em class="parameter"><code>n_items</code></em> :</span></p></td><td> number of items</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id3209934"></a><h3><a name="gtk-stock-item-copy"></a>gtk_stock_item_copy ()</h3><a class="indexterm" name="id3209947"></a><pre class="programlisting"><a class="link" href="gtk-Stock-Items.html#GtkStockItem">GtkStockItem</a>* gtk_stock_item_copy (const <a class="link" href="gtk-Stock-Items.html#GtkStockItem">GtkStockItem</a> *item);</pre><p>Copies a stock item, mostly useful for language bindings and not in applications.</p><p></p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><p><span class="term"><em class="parameter"><code>item</code></em> :</span></p></td><td> a <a class="link" href="gtk-Stock-Items.html#GtkStockItem"><span class="type">GtkStockItem</span></a></td></tr>
⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -