<?xml version="1.0" standalone="no"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
    "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">

<refentry id="gtk-stock-items">
  <refnamediv>
    <refname>Stock Items</refname>
    <refpurpose>prebuilt common menu/toolbar items and corresponding
icons</refpurpose>
  </refnamediv>

  <refsect1>
    <title>Synopsis</title>

    <programlisting>
<emphasis role="bold">Functions</emphasis>

<methodsynopsis language="python">
	<methodname><link linkend="function-gtk--stock-add">gtk.stock_add</link></methodname>
	<methodparam><parameter role="keyword">items</parameter></methodparam>
      </methodsynopsis><methodsynopsis language="python">
	<methodname><link linkend="function-gtk--stock-lookup">gtk.stock_lookup</link></methodname>
	<methodparam><parameter>stock_id</parameter></methodparam>
      </methodsynopsis><methodsynopsis language="python">
	<methodname><link linkend="function-gtk--stock-list-ids">gtk.stock_list_ids</link></methodname>
	<methodparam><parameter role="keyword"></parameter></methodparam>
      </methodsynopsis></programlisting>

  </refsect1>

  <refsect1>
    <title>Description</title>

    <para>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 <literal>gtk.STOCK_OPEN</literal> are
provided to avoid typing mistakes in the strings. Applications can register
their own stock items in addition to those built-in to
<literal>PyGTK</literal>.</para>

    <para>The stock items are:</para>

    <variablelist>
      <varlistentry>
	<term><literal>gtk.STOCK_ABOUT</literal></term>
	<listitem>
	  <simpara><inlinemediaobject>
              <imageobject>
                <imagedata fileref="icons/stock_about_24.png" format="png"/>
              </imageobject>
            </inlinemediaobject> Available in GTK+ 2.6 and above.</simpara>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><literal>gtk.STOCK_ADD</literal></term>
	<listitem>
	  <simpara><inlinemediaobject>
              <imageobject>
                <imagedata fileref="icons/stock_add_24.png" format="png"/>
              </imageobject>
            </inlinemediaobject></simpara>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><literal>gtk.STOCK_APPLY</literal></term>
	<listitem>
	  <simpara><inlinemediaobject>
              <imageobject>
                <imagedata fileref="icons/stock_apply_20.png" format="png"/>
              </imageobject>
            </inlinemediaobject></simpara>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><literal>gtk.STOCK_BOLD</literal></term>
	<listitem>
	  <simpara><inlinemediaobject>
              <imageobject>
                <imagedata fileref="icons/stock_text_bold_24.png" format="png"/>
              </imageobject>
            </inlinemediaobject></simpara>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><literal>gtk.STOCK_CANCEL</literal></term>
	<listitem>
	  <simpara><inlinemediaobject>
              <imageobject>
                <imagedata fileref="icons/stock_cancel_20.png" format="png"/>
              </imageobject>
            </inlinemediaobject></simpara>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><literal>gtk.STOCK_CDROM</literal></term>
	<listitem>
	  <simpara><inlinemediaobject>
              <imageobject>
                <imagedata fileref="icons/stock_cdrom_24.png" format="png"/>
              </imageobject>
            </inlinemediaobject></simpara>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><literal>gtk.STOCK_CLEAR</literal></term>
	<listitem>
	  <simpara><inlinemediaobject>
              <imageobject>
                <imagedata fileref="icons/stock_clear_24.png" format="png"/>
              </imageobject>
            </inlinemediaobject></simpara>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><literal>gtk.STOCK_CLOSE</literal></term>
	<listitem>
	  <simpara><inlinemediaobject>
              <imageobject>
                <imagedata fileref="icons/stock_close_24.png" format="png"/>
              </imageobject>
            </inlinemediaobject></simpara>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><literal>gtk.STOCK_COLOR_PICKER</literal></term>
	<listitem>
	  <simpara><inlinemediaobject>
              <imageobject>
                <imagedata fileref="icons/stock_color_picker_25.png"
	      format="png"/>
              </imageobject>
            </inlinemediaobject> Available in GTK+ 2.2 and above.</simpara>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><literal>gtk.STOCK_CONVERT</literal></term>
	<listitem>
	  <simpara><inlinemediaobject>
              <imageobject>
                <imagedata fileref="icons/stock_convert_24.png" format="png"/>
              </imageobject>
            </inlinemediaobject></simpara>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><literal>gtk.STOCK_CONNECT</literal></term>
	<listitem>
	  <simpara><inlinemediaobject>
              <imageobject>
                <imagedata fileref="icons/stock_connect_24.png" format="png"/>
              </imageobject>
            </inlinemediaobject> Available in GTK+ 2.6 and above.</simpara>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><literal>gtk.STOCK_COPY</literal></term>
	<listitem>
	  <simpara><inlinemediaobject>
              <imageobject>
                <imagedata fileref="icons/stock_copy_24.png" format="png"/>
              </imageobject>
            </inlinemediaobject></simpara>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><literal>gtk.STOCK_CUT</literal></term>
	<listitem>
	  <simpara><inlinemediaobject>
              <imageobject>
                <imagedata fileref="icons/stock_cut_24.png" format="png"/>
              </imageobject>
            </inlinemediaobject></simpara>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><literal>gtk.STOCK_DELETE</literal></term>
	<listitem>
	  <simpara><inlinemediaobject>
              <imageobject>
                <imagedata fileref="icons/stock_trash_24.png" format="png"/>
              </imageobject>
            </inlinemediaobject></simpara>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><literal>gtk.STOCK_DIALOG_AUTHENTICATION</literal></term>
	<listitem>
	  <simpara><inlinemediaobject>
              <imageobject>
                <imagedata fileref="icons/stock_dialog_authentication_48.png"
	      format="png"/>
              </imageobject>
            </inlinemediaobject> Available in GTK+ 2.4 and above.</simpara>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><literal>gtk.STOCK_DIALOG_ERROR</literal></term>
	<listitem>
	  <simpara><inlinemediaobject>
              <imageobject>
                <imagedata fileref="icons/stock_dialog_error_48.png" format="png"/>
              </imageobject>
            </inlinemediaobject></simpara>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><literal>gtk.STOCK_DIALOG_INFO</literal></term>
	<listitem>
	  <simpara><inlinemediaobject>
              <imageobject>
                <imagedata fileref="icons/stock_dialog_info_48.png" format="png"/>
              </imageobject>
            </inlinemediaobject></simpara>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><literal>gtk.STOCK_DIALOG_QUESTION</literal></term>
	<listitem>
	  <simpara><inlinemediaobject>
              <imageobject>
                <imagedata fileref="icons/stock_dialog_question_48.png" format="png"/>
              </imageobject>
            </inlinemediaobject></simpara>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><literal>gtk.STOCK_DIALOG_WARNING</literal></term>
	<listitem>
	  <simpara><inlinemediaobject>
              <imageobject>
                <imagedata fileref="icons/stock_dialog_warning_48.png" format="png"/>
              </imageobject>
            </inlinemediaobject></simpara>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><literal>gtk.STOCK_DIRECTORY</literal></term>
	<listitem>
	  <simpara><inlinemediaobject>
              <imageobject>
                <imagedata fileref="icons/stock_directory_24.png" format="png"/>
              </imageobject>
            </inlinemediaobject> Available in GTK+ 2.6 and above.</simpara>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><literal>gtk.STOCK_DISCONNECT</literal></term>
	<listitem>
	  <simpara><inlinemediaobject>
              <imageobject>
                <imagedata fileref="icons/stock_disconnect_24.png" format="png"/>
              </imageobject>
            </inlinemediaobject> Available in GTK+ 2.6 and above.</simpara>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><literal>gtk.STOCK_DND</literal></term>
	<listitem>
	  <simpara><inlinemediaobject>
              <imageobject>
                <imagedata fileref="icons/stock_dnd_32.png" format="png"/>
              </imageobject>
            </inlinemediaobject></simpara>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><literal>gtk.STOCK_DND_MULTIPLE</literal></term>
	<listitem>
	  <simpara><inlinemediaobject>
              <imageobject>
                <imagedata fileref="icons/stock_dnd_multiple_32.png" format="png"/>
              </imageobject>
            </inlinemediaobject></simpara>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><literal>gtk.STOCK_EDIT</literal></term>
	<listitem>
	  <simpara><inlinemediaobject>
              <imageobject>
                <imagedata fileref="icons/stock_edit_24.png" format="png"/>
              </imageobject>
            </inlinemediaobject> Available in GTK+ 2.6 and above.</simpara>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><literal>gtk.STOCK_EXECUTE</literal></term>
	<listitem>
	  <simpara><inlinemediaobject>
              <imageobject>
                <imagedata fileref="icons/stock_exec_24.png" format="png"/>
              </imageobject>
            </inlinemediaobject></simpara>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><literal>gtk.STOCK_FILE</literal></term>
	<listitem>
	  <simpara><inlinemediaobject>
              <imageobject>
                <imagedata fileref="icons/stock_file_24.png" format="png"/>
              </imageobject>
            </inlinemediaobject> Available in GTK+ 2.6 and above.</simpara>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><literal>gtk.STOCK_FIND</literal></term>
	<listitem>
	  <simpara><inlinemediaobject>
              <imageobject>
                <imagedata fileref="icons/stock_search_24.png" format="png"/>
              </imageobject>
            </inlinemediaobject></simpara>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><literal>gtk.STOCK_FIND_AND_REPLACE</literal></term>
	<listitem>
	  <simpara><inlinemediaobject>
              <imageobject>
                <imagedata fileref="icons/stock_search_replace_24.png" format="png"/>
              </imageobject>
            </inlinemediaobject></simpara>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><literal>gtk.STOCK_FLOPPY</literal></term>
	<listitem>
	  <simpara><inlinemediaobject>
              <imageobject>
                <imagedata fileref="icons/stock_save_24.png" format="png"/>
              </imageobject>
            </inlinemediaobject></simpara>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><literal>gtk.STOCK_FULLSCREEN</literal></term>
	<listitem>
	  <simpara><inlinemediaobject>
              <imageobject>
                <imagedata fileref="icons/stock_fullscreen_24.png" format="png"/>
              </imageobject>
            </inlinemediaobject> Available in GTK+ 2.8 and above.</simpara>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><literal>gtk.STOCK_GOTO_BOTTOM</literal></term>
	<listitem>
	  <simpara><inlinemediaobject>
              <imageobject>
                <imagedata fileref="icons/stock_bottom_24.png" format="png"/>
              </imageobject>
            </inlinemediaobject></simpara>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><literal>gtk.STOCK_GOTO_FIRST</literal></term>
	<listitem>
	  <simpara><inlinemediaobject>
              <imageobject>
                <imagedata fileref="icons/stock_first_24.png" format="png"/>
              </imageobject>
            </inlinemediaobject></simpara>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><literal>gtk.STOCK_GOTO_LAST</literal></term>
	<listitem>
	  <simpara><inlinemediaobject>
              <imageobject>
                <imagedata fileref="icons/stock_last_24.png" format="png"/>
              </imageobject>
            </inlinemediaobject></simpara>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><literal>gtk.STOCK_GOTO_TOP</literal></term>
	<listitem>
	  <simpara><inlinemediaobject>
              <imageobject>
                <imagedata fileref="icons/stock_top_24.png" format="png"/>
              </imageobject>
            </inlinemediaobject></simpara>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><literal>gtk.STOCK_GO_BACK</literal></term>
	<listitem>
	  <simpara><inlinemediaobject>
              <imageobject>
                <imagedata fileref="icons/stock_left_arrow_24.png" format="png"/>
              </imageobject>
            </inlinemediaobject></simpara>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><literal>gtk.STOCK_GO_DOWN</literal></term>
	<listitem>
	  <simpara><inlinemediaobject>
              <imageobject>
                <imagedata fileref="icons/stock_down_arrow_24.png" format="png"/>
              </imageobject>
            </inlinemediaobject></simpara>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><literal>gtk.STOCK_GO_FORWARD</literal></term>
	<listitem>
	  <simpara><inlinemediaobject>
              <imageobject>
                <imagedata fileref="icons/stock_right_arrow_24.png" format="png"/>
              </imageobject>
            </inlinemediaobject></simpara>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><literal>gtk.STOCK_GO_UP</literal></term>
	<listitem>
	  <simpara><inlinemediaobject>
              <imageobject>
                <imagedata fileref="icons/stock_up_arrow_24.png" format="png"/>
              </imageobject>
            </inlinemediaobject></simpara>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><literal>gtk.STOCK_HARDDISK</literal></term>
	<listitem>
	  <simpara><inlinemediaobject>
              <imageobject>
                <imagedata fileref="icons/stock_harddisk_24.png" format="png"/>
              </imageobject>
            </inlinemediaobject> Available in GTK+ 2.4 and above</simpara>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><literal>gtk.STOCK_HELP</literal></term>
	<listitem>
	  <simpara><inlinemediaobject>
              <imageobject>
                <imagedata fileref="icons/stock_help_24.png" format="png"/>
              </imageobject>
            </inlinemediaobject></simpara>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><literal>gtk.STOCK_HOME</literal></term>
	<listitem>
	  <simpara><inlinemediaobject>
              <imageobject>
                <imagedata fileref="icons/stock_home_24.png" format="png"/>
              </imageobject>
            </inlinemediaobject></simpara>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><literal>gtk.STOCK_INDENT</literal></term>
	<listitem>
	  <simpara><inlinemediaobject>
              <imageobject>
                <imagedata fileref="icons/stock_text_indent_24.png" format="png"/>
              </imageobject>
            </inlinemediaobject> Available in GTK+ 2.4 and above.</simpara>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><literal>gtk.STOCK_INDEX</literal></term>
	<listitem>
	  <simpara><inlinemediaobject>
              <imageobject>
                <imagedata fileref="icons/stock_index_24.png" format="png"/>
              </imageobject>
            </inlinemediaobject></simpara>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><literal>gtk.STOCK_INFO</literal></term>
	<listitem>
	  <simpara><inlinemediaobject>
              <imageobject>
                <imagedata fileref="icons/stock_info_24.png" format="png"/>
              </imageobject>
            </inlinemediaobject> Available in GTK+ 2.8 and above.</simpara>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><literal>gtk.STOCK_ITALIC</literal></term>
	<listitem>
	  <simpara><inlinemediaobject>
              <imageobject>
                <imagedata fileref="icons/stock_text_italic_24.png" format="png"/>
              </imageobject>
            </inlinemediaobject></simpara>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><literal>gtk.STOCK_JUMP_TO</literal></term>
	<listitem>
	  <simpara><inlinemediaobject>
              <imageobject>
                <imagedata fileref="icons/stock_jump_to_24.png" format="png"/>
              </imageobject>
            </inlinemediaobject> RTL version is <inlinemediaobject>
              <imageobject>
                <imagedata fileref="icons/stock_jump_to_rtl_24.png" format="png"/>
              </imageobject>
            </inlinemediaobject></simpara>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><literal>gtk.STOCK_JUSTIFY_CENTER</literal></term>
	<listitem>
	  <simpara><inlinemediaobject>
              <imageobject>
                <imagedata fileref="icons/stock_align_center_24.png" format="png"/>
              </imageobject>
            </inlinemediaobject></simpara>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><literal>gtk.STOCK_JUSTIFY_FILL</literal></term>
	<listitem>
	  <simpara><inlinemediaobject>
              <imageobject>
                <imagedata fileref="icons/stock_align_justify_24.png" format="png"/>
              </imageobject>
            </inlinemediaobject></simpara>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><literal>gtk.STOCK_JUSTIFY_LEFT</literal></term>
	<listitem>
	  <simpara><inlinemediaobject>
              <imageobject>
                <imagedata fileref="icons/stock_align_left_24.png" format="png"/>
              </imageobject>
            </inlinemediaobject></simpara>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><literal>gtk.STOCK_JUSTIFY_RIGHT</literal></term>
	<listitem>
	  <simpara><inlinemediaobject>
              <imageobject>
                <imagedata fileref="icons/stock_align_right_24.png" format="png"/>
              </imageobject>
            </inlinemediaobject></simpara>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><literal>gtk.STOCK_LEAVE_FULLSCREEN</literal></term>
	<listitem>
	  <simpara><inlinemediaobject>
              <imageobject>
                <imagedata fileref="icons/stock_leave_fullscreen_24.png" format="png"/>
              </imageobject>
            </inlinemediaobject> Available in GTK+ 2.8 and above.</simpara>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><literal>gtk.STOCK_MEDIA_FORWARD</literal></term>
	<listitem>
	  <simpara><inlinemediaobject>
              <imageobject>
                <imagedata fileref="icons/stock_media_forward_24.png" format="png"/>
              </imageobject>
            </inlinemediaobject> Available in GTK+ 2.6 and above.</simpara>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><literal>gtk.STOCK_MEDIA_NEXT</literal></term>
	<listitem>
	  <simpara><inlinemediaobject>
              <imageobject>
                <imagedata fileref="icons/stock_media_next_24.png" format="png"/>
              </imageobject>
            </inlinemediaobject> Available in GTK+ 2.6 and above.</simpara>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><literal>gtk.STOCK_MEDIA_PAUSE</literal></term>
	<listitem>
	  <simpara><inlinemediaobject>
              <imageobject>
                <imagedata fileref="icons/stock_media_pause_24.png" format="png"/>
              </imageobject>
            </inlinemediaobject> Available in GTK+ 2.6 and above.</simpara>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><literal>gtk.STOCK_MEDIA_PLAY</literal></term>
	<listitem>
	  <simpara><inlinemediaobject>
              <imageobject>
                <imagedata fileref="icons/stock_media_play_24.png" format="png"/>
              </imageobject>
            </inlinemediaobject> RTL version is <inlinemediaobject>
              <imageobject>
                <imagedata fileref="icons/stock_media_play_rtl_24.png" format="png"/>
              </imageobject>
            </inlinemediaobject> Available in GTK+ 2.6 and above.</simpara>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><literal>gtk.STOCK_MEDIA_PREVIOUS</literal></term>
	<listitem>
	  <simpara><inlinemediaobject>
              <imageobject>
                <imagedata fileref="icons/stock_media_previous_24.png" format="png"/>
              </imageobject>
            </inlinemediaobject> Available in GTK+ 2.6 and above.</simpara>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><literal>gtk.STOCK_MEDIA_RECORD</literal></term>
	<listitem>
	  <simpara><inlinemediaobject>
              <imageobject>
                <imagedata fileref="icons/stock_media_record_24.png" format="png"/>
              </imageobject>
            </inlinemediaobject> Available in GTK+ 2.6 and above.</simpara>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><literal>gtk.STOCK_MEDIA_REWIND</literal></term>
	<listitem>
	  <simpara><inlinemediaobject>
              <imageobject>
                <imagedata fileref="icons/stock_media_rewind_24.png" format="png"/>
              </imageobject>
            </inlinemediaobject> Available in GTK+ 2.6 and above.</simpara>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><literal>gtk.STOCK_MEDIA_STOP</literal></term>
	<listitem>
	  <simpara><inlinemediaobject>
              <imageobject>
                <imagedata fileref="icons/stock_media_stop_24.png" format="png"/>
              </imageobject>
            </inlinemediaobject> Available in GTK+ 2.6 and above.</simpara>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><literal>gtk.STOCK_MISSING_IMAGE</literal></term>
	<listitem>
	  <simpara><inlinemediaobject>
              <imageobject>
                <imagedata fileref="icons/stock_broken_image_24.png" format="png"/>
              </imageobject>
            </inlinemediaobject></simpara>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><literal>gtk.STOCK_NETWORK</literal></term>
	<listitem>
	  <simpara><inlinemediaobject>
              <imageobject>
                <imagedata fileref="icons/stock_network_24.png" format="png"/>
              </imageobject>
            </inlinemediaobject>
Available in GTK+ 2.4 and above.</simpara>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><literal>gtk.STOCK_NEW</literal></term>
	<listitem>
	  <simpara><inlinemediaobject>
              <imageobject>
                <imagedata fileref="icons/stock_new_24.png" format="png"/>
              </imageobject>
            </inlinemediaobject></simpara>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><literal>gtk.STOCK_NO</literal></term>
	<listitem>
	  <simpara><inlinemediaobject>
              <imageobject>
                <imagedata fileref="icons/stock_no_20.png" format="png"/>
              </imageobject>
            </inlinemediaobject></simpara>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><literal>gtk.STOCK_OK</literal></term>
	<listitem>
	  <simpara><inlinemediaobject>
              <imageobject>
                <imagedata fileref="icons/stock_ok_20.png" format="png"/>
              </imageobject>
            </inlinemediaobject></simpara>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><literal>gtk.STOCK_OPEN</literal></term>
	<listitem>
	  <simpara><inlinemediaobject>
              <imageobject>
                <imagedata fileref="icons/stock_open_24.png" format="png"/>
              </imageobject>
            </inlinemediaobject></simpara>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><literal>gtk.STOCK_PAGE_SETUP</literal></term>
	<listitem>
	  <simpara><inlinemediaobject>
              <imageobject>
                <imagedata fileref="icons/stock_page_setup_24.png" format="png"/>
              </imageobject>
            </inlinemediaobject>Available in GTK+ 2.14 and above.</simpara>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><literal>gtk.STOCK_PASTE</literal></term>
	<listitem>
	  <simpara><inlinemediaobject>
              <imageobject>
                <imagedata fileref="icons/stock_paste_24.png" format="png"/>
              </imageobject>
            </inlinemediaobject></simpara>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><literal>gtk.STOCK_PREFERENCES</literal></term>
	<listitem>
	  <simpara><inlinemediaobject>
              <imageobject>
                <imagedata fileref="icons/stock_preferences_24.png" format="png"/>
              </imageobject>
            </inlinemediaobject></simpara>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><literal>gtk.STOCK_PRINT</literal></term>
	<listitem>
	  <simpara><inlinemediaobject>
              <imageobject>
                <imagedata fileref="icons/stock_print_24.png" format="png"/>
              </imageobject>
            </inlinemediaobject></simpara>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><literal>gtk.STOCK_PRINT_ERROR</literal></term>
	<listitem>
	  <simpara><inlinemediaobject>
              <imageobject>
                <imagedata fileref="icons/stock_print_error_24.png" format="png"/>
              </imageobject>
            </inlinemediaobject>Available in GTK+ 2.14 and above.</simpara>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><literal>gtk.STOCK_PRINT_PAUSED</literal></term>
	<listitem>
	  <simpara><inlinemediaobject>
              <imageobject>
                <imagedata fileref="icons/stock_print_paused_24.png" format="png"/>
              </imageobject>
            </inlinemediaobject>Available in GTK+ 2.14 and above.</simpara>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><literal>gtk.STOCK_PRINT_PREVIEW</literal></term>
	<listitem>
	  <simpara><inlinemediaobject>
              <imageobject>
                <imagedata fileref="icons/stock_print_preview_24.png" format="png"/>
              </imageobject>
            </inlinemediaobject></simpara>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><literal>gtk.STOCK_PRINT_REPORT</literal></term>
	<listitem>
	  <simpara><inlinemediaobject>
              <imageobject>
                <imagedata fileref="icons/stock_print_report_24.png" format="png"/>
              </imageobject>
            </inlinemediaobject>Available in GTK+ 2.14 and above.</simpara>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><literal>gtk.STOCK_PRINT_WARNING</literal></term>
	<listitem>
	  <simpara><inlinemediaobject>
              <imageobject>
                <imagedata fileref="icons/stock_print_warning_24.png" format="png"/>
              </imageobject>
            </inlinemediaobject>Available in GTK+ 2.14 and above.</simpara>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><literal>gtk.STOCK_PROPERTIES</literal></term>
	<listitem>
	  <simpara><inlinemediaobject>
              <imageobject>
                <imagedata fileref="icons/stock_properties_24.png" format="png"/>
              </imageobject>
            </inlinemediaobject></simpara>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><literal>gtk.STOCK_QUIT</literal></term>
	<listitem>
	  <simpara><inlinemediaobject>
              <imageobject>
                <imagedata fileref="icons/stock_exit_24.png" format="png"/>
              </imageobject>
            </inlinemediaobject></simpara>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><literal>gtk.STOCK_REDO</literal></term>
	<listitem>
	  <simpara><inlinemediaobject>
              <imageobject>
                <imagedata fileref="icons/stock_redo_24.png" format="png"/>
              </imageobject>
            </inlinemediaobject> RTL version is <inlinemediaobject>
              <imageobject>
                <imagedata fileref="icons/stock_redo_rtl_24.png" format="png"/>
              </imageobject>
            </inlinemediaobject></simpara>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><literal>gtk.STOCK_REFRESH</literal></term>
	<listitem>
	  <simpara><inlinemediaobject>
              <imageobject>
                <imagedata fileref="icons/stock_refresh_24.png" format="png"/>
              </imageobject>
            </inlinemediaobject></simpara>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><literal>gtk.STOCK_REMOVE</literal></term>
	<listitem>
	  <simpara><inlinemediaobject>
              <imageobject>
                <imagedata fileref="icons/stock_remove_24.png" format="png"/>
              </imageobject>
            </inlinemediaobject></simpara>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><literal>gtk.STOCK_REVERT_TO_SAVED</literal></term>
	<listitem>
	  <simpara><inlinemediaobject>
              <imageobject>
                <imagedata fileref="icons/stock_revert_24.png" format="png"/>
              </imageobject>
            </inlinemediaobject> RTL version is <inlinemediaobject>
              <imageobject>
                <imagedata fileref="icons/stock_revert_rtl_24.png" format="png"/>
              </imageobject>
            </inlinemediaobject></simpara>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><literal>gtk.STOCK_SAVE</literal></term>
	<listitem>
	  <simpara><inlinemediaobject>
              <imageobject>
                <imagedata fileref="icons/stock_save_24.png" format="png"/>
              </imageobject>
            </inlinemediaobject></simpara>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><literal>gtk.STOCK_SAVE_AS</literal></term>
	<listitem>
	  <simpara><inlinemediaobject>
              <imageobject>
                <imagedata fileref="icons/stock_save_as_24.png" format="png"/>
              </imageobject>
            </inlinemediaobject></simpara>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><literal>gtk.STOCK_SELECT_COLOR</literal></term>
	<listitem>
	  <simpara><inlinemediaobject>
              <imageobject>
                <imagedata fileref="icons/stock_colorselector_24.png" format="png"/>
              </imageobject>
            </inlinemediaobject></simpara>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><literal>gtk.STOCK_SELECT_FONT</literal></term>
	<listitem>
	  <simpara><inlinemediaobject>
              <imageobject>
                <imagedata fileref="icons/stock_font_24.png" format="png"/>
              </imageobject>
            </inlinemediaobject></simpara>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><literal>gtk.STOCK_SORT_ASCENDING</literal></term>
	<listitem>
	  <simpara><inlinemediaobject>
              <imageobject>
                <imagedata fileref="icons/stock_sort_ascending_24.png" format="png"/>
              </imageobject>
            </inlinemediaobject></simpara>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><literal>gtk.STOCK_SORT_DESCENDING</literal></term>
	<listitem>
	  <simpara><inlinemediaobject>
              <imageobject>
                <imagedata fileref="icons/stock_sort_descending_24.png" format="png"/>
              </imageobject>
            </inlinemediaobject></simpara>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><literal>gtk.STOCK_SPELL_CHECK</literal></term>
	<listitem>
	  <simpara><inlinemediaobject>
              <imageobject>
                <imagedata fileref="icons/stock_spellcheck_24.png" format="png"/>
              </imageobject>
            </inlinemediaobject></simpara>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><literal>gtk.STOCK_STOP</literal></term>
	<listitem>
	  <simpara><inlinemediaobject>
              <imageobject>
                <imagedata fileref="icons/stock_stop_24.png" format="png"/>
              </imageobject>
            </inlinemediaobject></simpara>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><literal>gtk.STOCK_STRIKETHROUGH</literal></term>
	<listitem>
	  <simpara><inlinemediaobject>
              <imageobject>
                <imagedata fileref="icons/stock_text_strikethrough_24.png" format="png"/>
              </imageobject>
            </inlinemediaobject></simpara>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><literal>gtk.STOCK_UNDELETE</literal></term>
	<listitem>
	  <simpara><inlinemediaobject>
              <imageobject>
                <imagedata fileref="icons/stock_undelete_24.png" format="png"/>
              </imageobject>
            </inlinemediaobject> RTL version is <inlinemediaobject>
              <imageobject>
                <imagedata fileref="icons/stock_undelete_rtl_24.png" format="png"/>
              </imageobject>
            </inlinemediaobject></simpara>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><literal>gtk.STOCK_UNDERLINE</literal></term>
	<listitem>
	  <simpara><inlinemediaobject>
              <imageobject>
                <imagedata fileref="icons/stock_text_underline_24.png" format="png"/>
              </imageobject>
            </inlinemediaobject></simpara>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><literal>gtk.STOCK_UNDO</literal></term>
	<listitem>
	  <simpara><inlinemediaobject>
              <imageobject>
                <imagedata fileref="icons/stock_undo_24.png" format="png"/>
              </imageobject>
            </inlinemediaobject> RTL version is <inlinemediaobject>
              <imageobject>
                <imagedata fileref="icons/stock_undo_rtl_24.png" format="png"/>
              </imageobject>
            </inlinemediaobject></simpara>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><literal>gtk.STOCK_UNINDENT</literal></term>
	<listitem>
	  <simpara><inlinemediaobject>
              <imageobject>
                <imagedata fileref="icons/stock_text_unindent_24.png" format="png"/>
              </imageobject>
            </inlinemediaobject> Available in GTK+ 2.4 and above.</simpara>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><literal>gtk.STOCK_YES</literal></term>
	<listitem>
	  <simpara><inlinemediaobject>
              <imageobject>
                <imagedata fileref="icons/stock_yes_20.png" format="png"/>
              </imageobject>
            </inlinemediaobject></simpara>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><literal>gtk.STOCK_ZOOM_100</literal></term>
	<listitem>
	  <simpara><inlinemediaobject>
              <imageobject>
                <imagedata fileref="icons/stock_zoom_1_24.png" format="png"/>
              </imageobject>
            </inlinemediaobject></simpara>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><literal>gtk.STOCK_ZOOM_FIT</literal></term>
	<listitem>
	  <simpara><inlinemediaobject>
              <imageobject>
                <imagedata fileref="icons/stock_zoom_fit_24.png" format="png"/>
              </imageobject>
            </inlinemediaobject></simpara>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><literal>gtk.STOCK_ZOOM_IN</literal></term>
	<listitem>
	  <simpara><inlinemediaobject>
              <imageobject>
                <imagedata fileref="icons/stock_zoom_in_24.png" format="png"/>
              </imageobject>
            </inlinemediaobject></simpara>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><literal>gtk.STOCK_ZOOM_OUT</literal></term>
	<listitem>
	  <simpara><inlinemediaobject>
              <imageobject>
                <imagedata fileref="icons/stock_zoom_out_24.png" format="png"/>
              </imageobject>
            </inlinemediaobject></simpara>
	</listitem>
      </varlistentry>
    </variablelist>

    <para></para>

  </refsect1>

  <refsect1>
    <title>Functions</title>

    <refsect2 id="function-gtk--stock-add">
      <title>gtk.stock_add</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>gtk.stock_add</methodname>
	  <methodparam><parameter
			 role="keyword">items</parameter></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><parameter role="keyword">items</parameter>&nbsp;:</term>
	  <listitem><simpara>a list or tuple containing 5-tuples of stock
	  items</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The <function>gtk.stock_add</function>() function registers each
of the stock items in the list or tuple specified by
<parameter>items</parameter>. The stock items are specified by a 5-tuple
containing:</para>

      <itemizedlist>
	<listitem>
	  <simpara>stock_id - a string identifier</simpara>
	</listitem>
	<listitem>
	  <simpara>label - a string to use for a label</simpara>
	</listitem>
	<listitem>
	  <simpara>modifier - a modifier mask (see the <xref
linkend="gdk-modifier-constants"
endterm="gdk-modifier-constants-title"></xref> section for more detail on
modifiers)</simpara>
	</listitem>
	<listitem>
	  <simpara>keyval - an integer key value (see <link
	  linkend="class-gdkkeymap"><classname>gtk.gdk.Keymap</classname></link>)
	  Together with the modifiers specifies an accelerator.</simpara>
	</listitem>
	<listitem>
	  <simpara>translation_domain - a string identifier of a translation
	  domain</simpara>
	</listitem>
      </itemizedlist>

      <para>If an item already exists with the same stock ID as one of the
items, the old item gets replaced.</para>

    </refsect2>

    <refsect2 id="function-gtk--stock-lookup">
      <title>gtk.stock_lookup</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>gtk.stock_lookup</methodname>
	  <methodparam><parameter>stock_id</parameter></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><parameter>stock_id</parameter>&nbsp;:</term>
	  <listitem><simpara>a stock item name</simpara></listitem>
	</varlistentry>
	<varlistentry>
	<term><emphasis>Returns</emphasis>&nbsp;:</term>
	  <listitem><simpara>a 5-tuple containing the stock item info or
	  <literal>None</literal> if <parameter>stock_id</parameter> is
	  unknown</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The <function>gtk.stock_lookup</function>() function looks up
the stock item identified by <parameter>stock_id</parameter> and returns a
5-tuple containing its information. If <parameter>stock_id</parameter> is
not known this function returns <literal>None</literal>. See the <link
linkend="function-gtk--stock-add"><function>gtk.stock_add</function>()</link>
function for more detail.</para>

    </refsect2>

    <refsect2 id="function-gtk--stock-list-ids">
      <title>gtk.stock_list_ids</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>gtk.stock_list_ids</methodname>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	<term><emphasis>Returns</emphasis>&nbsp;:</term>
	  <listitem><simpara>a list of known stock IDs</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The <function>gtk.stock_list_ids</function>() function returns a
list containing all of the known stock IDs added to a <link
linkend="class-gtkiconfactory"><classname>gtk.IconFactory</classname></link>
or registered with the <link
linkend="function-gtk--stock-add"><function>gtk.stock_add</function>()</link>
function.</para>

    </refsect2>

  </refsect1>

</refentry>
