<refentry id="GtkPixmapMenuItem" revision="20 Jun 2000">
<refmeta>
<refentrytitle>GtkPixmapMenuItem</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo>GNOMEUI Library</refmiscinfo>
</refmeta>

<refnamediv>
<refname>GtkPixmapMenuItem</refname><refpurpose>A special widget for GNOME menus.</refpurpose>
</refnamediv>

<refsynopsisdiv><title>Synopsis</title>
<synopsis>

#include &lt;gnome.h&gt;


struct      <link linkend="GtkPixmapMenuItem-struct">GtkPixmapMenuItem</link>;
<link linkend="GtkWidget">GtkWidget</link>*  <link linkend="gtk-pixmap-menu-item-new">gtk_pixmap_menu_item_new</link>        (void);
void        <link linkend="gtk-pixmap-menu-item-set-pixmap">gtk_pixmap_menu_item_set_pixmap</link> (<link linkend="GtkPixmapMenuItem">GtkPixmapMenuItem</link> *menu_item,
                                             <link linkend="GtkWidget">GtkWidget</link> *pixmap);

</synopsis>
</refsynopsisdiv>

<refsect1>
<title>Object Hierarchy</title>
<synopsis>

  <link linkend="GtkObject">GtkObject</link>
   +----<link linkend="GtkWidget">GtkWidget</link>
         +----<link linkend="GtkContainer">GtkContainer</link>
               +----<link linkend="GtkBin">GtkBin</link>
                     +----<link linkend="GtkItem">GtkItem</link>
                           +----<link linkend="GtkMenuItem">GtkMenuItem</link>
                                 +----GtkPixmapMenuItem
</synopsis>

</refsect1>




<refsect1>
<title>Description</title>
<para>
GtkPixmapMenuItem works like a normal GTK menu item, but you can insert a
arbitrary widget (most often a pixmap widget), which is displayed 
at the left side. The advantage is that indentation is handled the 
same way as GTK does (i.e if you create a menu with a gtk_check_menu_item, 
all normal menu items are automatically indented by GTK - so if you 
use a normal menu item to display pixmaps at the left side, the pixmaps 
will be indented, which is not what you want. This widget solves 
the problem).
</para>
</refsect1>

<refsect1>
<title>Details</title>
<refsect2>
<title><anchor id="GtkPixmapMenuItem-struct">struct GtkPixmapMenuItem</title>
<programlisting>struct GtkPixmapMenuItem;</programlisting>
<para>

</para></refsect2>
<refsect2>
<title><anchor id="gtk-pixmap-menu-item-new">gtk_pixmap_menu_item_new ()</title>
<programlisting><link linkend="GtkWidget">GtkWidget</link>*  gtk_pixmap_menu_item_new        (void);</programlisting>
<para>
Creates a new pixmap menu item. Use <link linkend="gtk-pixmap-menu-item-set-pixmap">gtk_pixmap_menu_item_set_pixmap</link>() 
to set the pixmap wich is displayed at the left side.</para>
<para>

</para><informaltable pgwide=1 frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry>
&amp;GtkWidget pointer to new menu item
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-pixmap-menu-item-set-pixmap">gtk_pixmap_menu_item_set_pixmap ()</title>
<programlisting>void        gtk_pixmap_menu_item_set_pixmap (<link linkend="GtkPixmapMenuItem">GtkPixmapMenuItem</link> *menu_item,
                                             <link linkend="GtkWidget">GtkWidget</link> *pixmap);</programlisting>
<para>
Set the pixmap of the menu item.</para>
<para>

</para><informaltable pgwide=1 frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>menu_item</parameter>&nbsp;:</entry>
<entry> Pointer to the pixmap menu item
</entry></row>
<row><entry align="right"><parameter>pixmap</parameter>&nbsp;:</entry>
<entry> Pointer to a pixmap widget
</entry></row>
</tbody></tgroup></informaltable></refsect2>

</refsect1>




</refentry>
