<refentry id="GtkItemFactory">
<refmeta>
<refentrytitle>GtkItemFactory</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo>GTK Library</refmiscinfo>
</refmeta>

<refnamediv>
<refname>GtkItemFactory</refname><refpurpose></refpurpose>
</refnamediv>

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

#include &lt;gtk/gtk.h&gt;


struct      <link linkend="GtkItemFactory-struct">GtkItemFactory</link>;
void        (<link linkend="GtkPrintFunc">*GtkPrintFunc</link>)                 (<link linkend="gpointer">gpointer</link> func_data,
                                             const <link linkend="gchar">gchar</link> *str);
<link linkend="gchar">gchar</link>*      (<link linkend="GtkTranslateFunc">*GtkTranslateFunc</link>)             (const <link linkend="gchar">gchar</link> *path,
                                             <link linkend="gpointer">gpointer</link> func_data);
void        (<link linkend="GtkItemFactoryCallback">*GtkItemFactoryCallback</link>)       ();
void        (<link linkend="GtkItemFactoryCallback1">*GtkItemFactoryCallback1</link>)      (<link linkend="gpointer">gpointer</link> callback_data,
                                             <link linkend="guint">guint</link> callback_action,
                                             <link linkend="GtkWidget">GtkWidget</link> *widget);
void        (<link linkend="GtkItemFactoryCallback2">*GtkItemFactoryCallback2</link>)      (<link linkend="GtkWidget">GtkWidget</link> *widget,
                                             <link linkend="gpointer">gpointer</link> callback_data,
                                             <link linkend="guint">guint</link> callback_action);
struct      <link linkend="GtkItemFactoryEntry">GtkItemFactoryEntry</link>;
struct      <link linkend="GtkItemFactoryItem">GtkItemFactoryItem</link>;
<link linkend="GtkItemFactory">GtkItemFactory</link>* <link linkend="gtk-item-factory-new">gtk_item_factory_new</link>        (<link linkend="GtkType">GtkType</link> container_type,
                                             const <link linkend="gchar">gchar</link> *path,
                                             <link linkend="GtkAccelGroup">GtkAccelGroup</link> *accel_group);
void        <link linkend="gtk-item-factory-construct">gtk_item_factory_construct</link>      (<link linkend="GtkItemFactory">GtkItemFactory</link> *ifactory,
                                             <link linkend="GtkType">GtkType</link> container_type,
                                             const <link linkend="gchar">gchar</link> *path,
                                             <link linkend="GtkAccelGroup">GtkAccelGroup</link> *accel_group);
void        <link linkend="gtk-item-factory-add-foreign">gtk_item_factory_add_foreign</link>    (<link linkend="GtkWidget">GtkWidget</link> *accel_widget,
                                             const <link linkend="gchar">gchar</link> *full_path,
                                             <link linkend="GtkAccelGroup">GtkAccelGroup</link> *accel_group,
                                             <link linkend="guint">guint</link> keyval,
                                             <link linkend="GdkModifierType">GdkModifierType</link> modifiers);
<link linkend="GtkItemFactory">GtkItemFactory</link>* <link linkend="gtk-item-factory-from-widget">gtk_item_factory_from_widget</link>
                                            (<link linkend="GtkWidget">GtkWidget</link> *widget);
G_CONST_RETURN <link linkend="gchar">gchar</link>* <link linkend="gtk-item-factory-path-from-widget">gtk_item_factory_path_from_widget</link>
                                            (<link linkend="GtkWidget">GtkWidget</link> *widget);
<link linkend="GtkWidget">GtkWidget</link>*  <link linkend="gtk-item-factory-get-item">gtk_item_factory_get_item</link>       (<link linkend="GtkItemFactory">GtkItemFactory</link> *ifactory,
                                             const <link linkend="gchar">gchar</link> *path);
<link linkend="GtkWidget">GtkWidget</link>*  <link linkend="gtk-item-factory-get-widget">gtk_item_factory_get_widget</link>     (<link linkend="GtkItemFactory">GtkItemFactory</link> *ifactory,
                                             const <link linkend="gchar">gchar</link> *path);
<link linkend="GtkWidget">GtkWidget</link>*  <link linkend="gtk-item-factory-get-widget-by-action">gtk_item_factory_get_widget_by_action</link>
                                            (<link linkend="GtkItemFactory">GtkItemFactory</link> *ifactory,
                                             <link linkend="guint">guint</link> action);
<link linkend="GtkWidget">GtkWidget</link>*  <link linkend="gtk-item-factory-get-item-by-action">gtk_item_factory_get_item_by_action</link>
                                            (<link linkend="GtkItemFactory">GtkItemFactory</link> *ifactory,
                                             <link linkend="guint">guint</link> action);
void        <link linkend="gtk-item-factory-create-item">gtk_item_factory_create_item</link>    (<link linkend="GtkItemFactory">GtkItemFactory</link> *ifactory,
                                             <link linkend="GtkItemFactoryEntry">GtkItemFactoryEntry</link> *entry,
                                             <link linkend="gpointer">gpointer</link> callback_data,
                                             <link linkend="guint">guint</link> callback_type);
void        <link linkend="gtk-item-factory-create-items">gtk_item_factory_create_items</link>   (<link linkend="GtkItemFactory">GtkItemFactory</link> *ifactory,
                                             <link linkend="guint">guint</link> n_entries,
                                             <link linkend="GtkItemFactoryEntry">GtkItemFactoryEntry</link> *entries,
                                             <link linkend="gpointer">gpointer</link> callback_data);
void        <link linkend="gtk-item-factory-create-items-ac">gtk_item_factory_create_items_ac</link>
                                            (<link linkend="GtkItemFactory">GtkItemFactory</link> *ifactory,
                                             <link linkend="guint">guint</link> n_entries,
                                             <link linkend="GtkItemFactoryEntry">GtkItemFactoryEntry</link> *entries,
                                             <link linkend="gpointer">gpointer</link> callback_data,
                                             <link linkend="guint">guint</link> callback_type);
void        <link linkend="gtk-item-factory-delete-item">gtk_item_factory_delete_item</link>    (<link linkend="GtkItemFactory">GtkItemFactory</link> *ifactory,
                                             const <link linkend="gchar">gchar</link> *path);
void        <link linkend="gtk-item-factory-delete-entry">gtk_item_factory_delete_entry</link>   (<link linkend="GtkItemFactory">GtkItemFactory</link> *ifactory,
                                             <link linkend="GtkItemFactoryEntry">GtkItemFactoryEntry</link> *entry);
void        <link linkend="gtk-item-factory-delete-entries">gtk_item_factory_delete_entries</link> (<link linkend="GtkItemFactory">GtkItemFactory</link> *ifactory,
                                             <link linkend="guint">guint</link> n_entries,
                                             <link linkend="GtkItemFactoryEntry">GtkItemFactoryEntry</link> *entries);
void        <link linkend="gtk-item-factory-popup">gtk_item_factory_popup</link>          (<link linkend="GtkItemFactory">GtkItemFactory</link> *ifactory,
                                             <link linkend="guint">guint</link> x,
                                             <link linkend="guint">guint</link> y,
                                             <link linkend="guint">guint</link> mouse_button,
                                             <link linkend="guint32">guint32</link> time);
void        <link linkend="gtk-item-factory-popup-with-data">gtk_item_factory_popup_with_data</link>
                                            (<link linkend="GtkItemFactory">GtkItemFactory</link> *ifactory,
                                             <link linkend="gpointer">gpointer</link> popup_data,
                                             <link linkend="GtkDestroyNotify">GtkDestroyNotify</link> destroy,
                                             <link linkend="guint">guint</link> x,
                                             <link linkend="guint">guint</link> y,
                                             <link linkend="guint">guint</link> mouse_button,
                                             <link linkend="guint32">guint32</link> time);
<link linkend="gpointer">gpointer</link>    <link linkend="gtk-item-factory-popup-data">gtk_item_factory_popup_data</link>     (<link linkend="GtkItemFactory">GtkItemFactory</link> *ifactory);
<link linkend="gpointer">gpointer</link>    <link linkend="gtk-item-factory-popup-data-from-widget">gtk_item_factory_popup_data_from_widget</link>
                                            (<link linkend="GtkWidget">GtkWidget</link> *widget);
<link linkend="GtkItemFactory">GtkItemFactory</link>* <link linkend="gtk-item-factory-from-path">gtk_item_factory_from_path</link>  (const <link linkend="gchar">gchar</link> *path);
void        <link linkend="gtk-item-factory-create-menu-entries">gtk_item_factory_create_menu_entries</link>
                                            (<link linkend="guint">guint</link> n_entries,
                                             <link linkend="GtkMenuEntry">GtkMenuEntry</link> *entries);
void        <link linkend="gtk-item-factories-path-delete">gtk_item_factories_path_delete</link>  (const <link linkend="gchar">gchar</link> *ifactory_path,
                                             const <link linkend="gchar">gchar</link> *path);
void        <link linkend="gtk-item-factory-set-translate-func">gtk_item_factory_set_translate_func</link>
                                            (<link linkend="GtkItemFactory">GtkItemFactory</link> *ifactory,
                                             <link linkend="GtkTranslateFunc">GtkTranslateFunc</link> func,
                                             <link linkend="gpointer">gpointer</link> data,
                                             <link linkend="GtkDestroyNotify">GtkDestroyNotify</link> notify);


</synopsis>
</refsynopsisdiv>

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

  <link linkend="GObject">GObject</link>
   +----<link linkend="GtkObject">GtkObject</link>
         +----GtkItemFactory
</synopsis>

</refsect1>




<refsect1>
<title>Description</title>
<para>

</para>
</refsect1>

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

</para></refsect2>
<refsect2>
<title><anchor id="GtkPrintFunc">GtkPrintFunc ()</title>
<programlisting>void        (*GtkPrintFunc)                 (<link linkend="gpointer">gpointer</link> func_data,
                                             const <link linkend="gchar">gchar</link> *str);</programlisting>
<para>

</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>func_data</parameter>&nbsp;:</entry>
<entry>
</entry></row>
<row><entry align="right"><parameter>str</parameter>&nbsp;:</entry>
<entry>


</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="GtkTranslateFunc">GtkTranslateFunc ()</title>
<programlisting><link linkend="gchar">gchar</link>*      (*GtkTranslateFunc)             (const <link linkend="gchar">gchar</link> *path,
                                             <link linkend="gpointer">gpointer</link> func_data);</programlisting>
<para>

</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>path</parameter>&nbsp;:</entry>
<entry>
</entry></row>
<row><entry align="right"><parameter>func_data</parameter>&nbsp;:</entry>
<entry>
</entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry>


</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="GtkItemFactoryCallback">GtkItemFactoryCallback ()</title>
<programlisting>void        (*GtkItemFactoryCallback)       ();</programlisting>
<para>

</para></refsect2>
<refsect2>
<title><anchor id="GtkItemFactoryCallback1">GtkItemFactoryCallback1 ()</title>
<programlisting>void        (*GtkItemFactoryCallback1)      (<link linkend="gpointer">gpointer</link> callback_data,
                                             <link linkend="guint">guint</link> callback_action,
                                             <link linkend="GtkWidget">GtkWidget</link> *widget);</programlisting>
<para>

</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>callback_data</parameter>&nbsp;:</entry>
<entry>
</entry></row>
<row><entry align="right"><parameter>callback_action</parameter>&nbsp;:</entry>
<entry>
</entry></row>
<row><entry align="right"><parameter>widget</parameter>&nbsp;:</entry>
<entry>


</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="GtkItemFactoryCallback2">GtkItemFactoryCallback2 ()</title>
<programlisting>void        (*GtkItemFactoryCallback2)      (<link linkend="GtkWidget">GtkWidget</link> *widget,
                                             <link linkend="gpointer">gpointer</link> callback_data,
                                             <link linkend="guint">guint</link> callback_action);</programlisting>
<warning>
<para>
<literal>GtkItemFactoryCallback2</literal> is deprecated and should not be used in newly-written code.
</para>
</warning>
<para>

</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>widget</parameter>&nbsp;:</entry>
<entry>
</entry></row>
<row><entry align="right"><parameter>callback_data</parameter>&nbsp;:</entry>
<entry>
</entry></row>
<row><entry align="right"><parameter>callback_action</parameter>&nbsp;:</entry>
<entry>


</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="GtkItemFactoryEntry">struct GtkItemFactoryEntry</title>
<programlisting>struct GtkItemFactoryEntry
{
  gchar *path;
  gchar *accelerator;

  GtkItemFactoryCallback callback;
  guint			 callback_action;

  /* possible values:
   * NULL		-&gt; "&lt;Item&gt;"
   * ""			-&gt; "&lt;Item&gt;"
   * "&lt;Title&gt;"		-&gt; create a title item
   * "&lt;Item&gt;"		-&gt; create a simple item
   * "&lt;ImageItem&gt;"	-&gt; create an item holding an image
   * "&lt;StockItem&gt;"	-&gt; create an item holding a stock image
   * "&lt;CheckItem&gt;"	-&gt; create a check item
   * "&lt;ToggleItem&gt;"	-&gt; create a toggle item
   * "&lt;RadioItem&gt;"	-&gt; create a radio item
   * &lt;path&gt;		-&gt; path of a radio item to link against
   * "&lt;Separator&gt;"	-&gt; create a separator
   * "&lt;Tearoff&gt;"	-&gt; create a tearoff separator
   * "&lt;Branch&gt;"		-&gt; create an item to hold sub items
   * "&lt;LastBranch&gt;"	-&gt; create a right justified item to hold sub items
   */
  gchar		 *item_type;

  /* Extra data for some item types:
   *  ImageItem  -&gt; pointer to inlined pixbuf stream
   *  StockItem  -&gt; name of stock item
   */
  gconstpointer extra_data;
};
</programlisting>
<para>

</para></refsect2>
<refsect2>
<title><anchor id="GtkItemFactoryItem">struct GtkItemFactoryItem</title>
<programlisting>struct GtkItemFactoryItem
{
  gchar *path;
  GSList *widgets;
};
</programlisting>
<para>

</para></refsect2>
<refsect2>
<title><anchor id="gtk-item-factory-new">gtk_item_factory_new ()</title>
<programlisting><link linkend="GtkItemFactory">GtkItemFactory</link>* gtk_item_factory_new        (<link linkend="GtkType">GtkType</link> container_type,
                                             const <link linkend="gchar">gchar</link> *path,
                                             <link linkend="GtkAccelGroup">GtkAccelGroup</link> *accel_group);</programlisting>
<para>
Creates a new <link linkend="GtkItemFactory">GtkItemFactory</link>.</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>container_type</parameter>&nbsp;:</entry>
<entry> the kind of menu to create; can be
   <link linkend="GTK-TYPE-MENU-BAR-CAPS">GTK_TYPE_MENU_BAR</link>, <link linkend="GTK-TYPE-MENU-CAPS">GTK_TYPE_MENU</link> or <link linkend="GTK-TYPE-OPTION-MENU-CAPS">GTK_TYPE_OPTION_MENU</link>
</entry></row>
<row><entry align="right"><parameter>path</parameter>&nbsp;:</entry>
<entry> the factory path of the new item factory, a string of the form 
   <literal>"&lt;name&gt;"</literal>
</entry></row>
<row><entry align="right"><parameter>accel_group</parameter>&nbsp;:</entry>
<entry> a <link linkend="GtkAccelGroup">GtkAccelGroup</link> to which the accelerators for the
   menu items will be added, or <literal>NULL</literal> to create a new one
</entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry> a new <link linkend="GtkItemFactory">GtkItemFactory</link>
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-item-factory-construct">gtk_item_factory_construct ()</title>
<programlisting>void        gtk_item_factory_construct      (<link linkend="GtkItemFactory">GtkItemFactory</link> *ifactory,
                                             <link linkend="GtkType">GtkType</link> container_type,
                                             const <link linkend="gchar">gchar</link> *path,
                                             <link linkend="GtkAccelGroup">GtkAccelGroup</link> *accel_group);</programlisting>
<para>
Initializes an item factory.</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>ifactory</parameter>&nbsp;:</entry>
<entry> a <link linkend="GtkItemFactory">GtkItemFactory</link>
</entry></row>
<row><entry align="right"><parameter>container_type</parameter>&nbsp;:</entry>
<entry> the kind of menu to create; can be
   <link linkend="GTK-TYPE-MENU-BAR-CAPS">GTK_TYPE_MENU_BAR</link>, <link linkend="GTK-TYPE-MENU-CAPS">GTK_TYPE_MENU</link> or <link linkend="GTK-TYPE-OPTION-MENU-CAPS">GTK_TYPE_OPTION_MENU</link>
</entry></row>
<row><entry align="right"><parameter>path</parameter>&nbsp;:</entry>
<entry> the factory path of <parameter>ifactory</parameter>, a string of the form 
   <literal>"&lt;name&gt;"</literal>
</entry></row>
<row><entry align="right"><parameter>accel_group</parameter>&nbsp;:</entry>
<entry> a <link linkend="GtkAccelGroup">GtkAccelGroup</link> to which the accelerators for the
   menu items will be added, or <literal>NULL</literal> to create a new one
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-item-factory-add-foreign">gtk_item_factory_add_foreign ()</title>
<programlisting>void        gtk_item_factory_add_foreign    (<link linkend="GtkWidget">GtkWidget</link> *accel_widget,
                                             const <link linkend="gchar">gchar</link> *full_path,
                                             <link linkend="GtkAccelGroup">GtkAccelGroup</link> *accel_group,
                                             <link linkend="guint">guint</link> keyval,
                                             <link linkend="GdkModifierType">GdkModifierType</link> modifiers);</programlisting>
<para>
Installs an accelerator for <parameter>accel_widget</parameter> in <parameter>accel_group</parameter>, that causes
the ::activate signal to be emitted if the accelerator is activated.
</para>
<para>
This function can be used to make widgets participate in the accel
saving/restoring functionality provided by <link linkend="gtk-accel-map-save">gtk_accel_map_save</link>() and
<link linkend="gtk-accel-map-load">gtk_accel_map_load</link>(), even if they haven't been created by an item
factory. The recommended API for this purpose are the functions 
<link linkend="gtk-menu-item-set-accel-path">gtk_menu_item_set_accel_path</link>() and <link linkend="gtk-widget-set-accel-path">gtk_widget_set_accel_path</link>(); don't 
use <link linkend="gtk-item-factory-add-foreign">gtk_item_factory_add_foreign</link>() in new code, since it is likely to
be removed in the future.</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>accel_widget</parameter>&nbsp;:</entry>
<entry>     widget to install an accelerator on 
</entry></row>
<row><entry align="right"><parameter>full_path</parameter>&nbsp;:</entry>
<entry>	      the full path for the <parameter>accel_widget</parameter> 
</entry></row>
<row><entry align="right"><parameter>accel_group</parameter>&nbsp;:</entry>
<entry>      the accelerator group to install the accelerator in
</entry></row>
<row><entry align="right"><parameter>keyval</parameter>&nbsp;:</entry>
<entry>           key value of the accelerator
</entry></row>
<row><entry align="right"><parameter>modifiers</parameter>&nbsp;:</entry>
<entry>        modifier combination of the accelerator
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-item-factory-from-widget">gtk_item_factory_from_widget ()</title>
<programlisting><link linkend="GtkItemFactory">GtkItemFactory</link>* gtk_item_factory_from_widget
                                            (<link linkend="GtkWidget">GtkWidget</link> *widget);</programlisting>
<para>
Obtains the item factory from which a widget was created.</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>widget</parameter>&nbsp;:</entry>
<entry> a widget
</entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry> the item factory from which <parameter>widget</parameter> was created, or <literal>NULL</literal>
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-item-factory-path-from-widget">gtk_item_factory_path_from_widget ()</title>
<programlisting>G_CONST_RETURN <link linkend="gchar">gchar</link>* gtk_item_factory_path_from_widget
                                            (<link linkend="GtkWidget">GtkWidget</link> *widget);</programlisting>
<para>
If <parameter>widget</parameter> has been created by an item factory, returns the full path
to it. (The full path of a widget is the concatenation of the factory 
path specified in <link linkend="gtk-item-factory-new">gtk_item_factory_new</link>() with the path specified in the 
<link linkend="GtkItemFactoryEntry">GtkItemFactoryEntry</link> from which the widget was created.)</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>widget</parameter>&nbsp;:</entry>
<entry> a widget
</entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry> the full path to <parameter>widget</parameter> if it been created by an item factory, 
  <literal>NULL</literal> otherwise. This value is owned by GTK+ and must not be
  modified or freed.
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-item-factory-get-item">gtk_item_factory_get_item ()</title>
<programlisting><link linkend="GtkWidget">GtkWidget</link>*  gtk_item_factory_get_item       (<link linkend="GtkItemFactory">GtkItemFactory</link> *ifactory,
                                             const <link linkend="gchar">gchar</link> *path);</programlisting>
<para>
Obtains the menu item which corresponds to <parameter>path</parameter>. 
</para>
<para>
If the widget corresponding to <parameter>path</parameter> is a menu item which opens a 
submenu, then the item is returned. If you are interested in the submenu, 
use <link linkend="gtk-item-factory-get-widget">gtk_item_factory_get_widget</link>() instead.</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>ifactory</parameter>&nbsp;:</entry>
<entry> a <link linkend="GtkItemFactory">GtkItemFactory</link>
</entry></row>
<row><entry align="right"><parameter>path</parameter>&nbsp;:</entry>
<entry> the path to the menu item
</entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry> the menu item for the given path, or <literal>NULL</literal> if <parameter>path</parameter> doesn't
  lead to a menu item
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-item-factory-get-widget">gtk_item_factory_get_widget ()</title>
<programlisting><link linkend="GtkWidget">GtkWidget</link>*  gtk_item_factory_get_widget     (<link linkend="GtkItemFactory">GtkItemFactory</link> *ifactory,
                                             const <link linkend="gchar">gchar</link> *path);</programlisting>
<para>
Obtains the widget which corresponds to <parameter>path</parameter>. 
</para>
<para>
If the widget corresponding to <parameter>path</parameter> is a menu item which opens a 
submenu, then the submenu is returned. If you are interested in the menu 
item, use <link linkend="gtk-item-factory-get-item">gtk_item_factory_get_item</link>() instead.</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>ifactory</parameter>&nbsp;:</entry>
<entry> a <link linkend="GtkItemFactory">GtkItemFactory</link>
</entry></row>
<row><entry align="right"><parameter>path</parameter>&nbsp;:</entry>
<entry> the path to the widget
</entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry> the widget for the given path, or <literal>NULL</literal> if <parameter>path</parameter> doesn't lead
  to a widget
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-item-factory-get-widget-by-action">gtk_item_factory_get_widget_by_action ()</title>
<programlisting><link linkend="GtkWidget">GtkWidget</link>*  gtk_item_factory_get_widget_by_action
                                            (<link linkend="GtkItemFactory">GtkItemFactory</link> *ifactory,
                                             <link linkend="guint">guint</link> action);</programlisting>
<para>
Obtains the widget which was constructed from the <link linkend="GtkItemFactoryEntry">GtkItemFactoryEntry</link>
with the given <parameter>action</parameter>.
</para>
<para>
If there are multiple items with the same action, the result is 
undefined.</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>ifactory</parameter>&nbsp;:</entry>
<entry> a <link linkend="GtkItemFactory">GtkItemFactory</link>
</entry></row>
<row><entry align="right"><parameter>action</parameter>&nbsp;:</entry>
<entry> an action as specified in the <parameter>callback_action</parameter> field
  of <link linkend="GtkItemFactoryEntry">GtkItemFactoryEntry</link>
</entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry> the widget which corresponds to the given action, or <literal>NULL</literal>
  if no widget was found
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-item-factory-get-item-by-action">gtk_item_factory_get_item_by_action ()</title>
<programlisting><link linkend="GtkWidget">GtkWidget</link>*  gtk_item_factory_get_item_by_action
                                            (<link linkend="GtkItemFactory">GtkItemFactory</link> *ifactory,
                                             <link linkend="guint">guint</link> action);</programlisting>
<para>
Obtains the menu item which was constructed from the first 
<link linkend="GtkItemFactoryEntry">GtkItemFactoryEntry</link> with the given <parameter>action</parameter>.</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>ifactory</parameter>&nbsp;:</entry>
<entry> a <link linkend="GtkItemFactory">GtkItemFactory</link>
</entry></row>
<row><entry align="right"><parameter>action</parameter>&nbsp;:</entry>
<entry> an action as specified in the <parameter>callback_action</parameter> field
  of <link linkend="GtkItemFactoryEntry">GtkItemFactoryEntry</link>
</entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry> the menu item which corresponds to the given action, or <literal>NULL</literal>
  if no menu item was found
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-item-factory-create-item">gtk_item_factory_create_item ()</title>
<programlisting>void        gtk_item_factory_create_item    (<link linkend="GtkItemFactory">GtkItemFactory</link> *ifactory,
                                             <link linkend="GtkItemFactoryEntry">GtkItemFactoryEntry</link> *entry,
                                             <link linkend="gpointer">gpointer</link> callback_data,
                                             <link linkend="guint">guint</link> callback_type);</programlisting>
<para>
Creates an item for <parameter>entry</parameter>.</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>ifactory</parameter>&nbsp;:</entry>
<entry> a <link linkend="GtkItemFactory">GtkItemFactory</link>
</entry></row>
<row><entry align="right"><parameter>entry</parameter>&nbsp;:</entry>
<entry> the <link linkend="GtkItemFactoryEntry">GtkItemFactoryEntry</link> to create an item for
</entry></row>
<row><entry align="right"><parameter>callback_data</parameter>&nbsp;:</entry>
<entry> data passed to the callback function of <parameter>entry</parameter>
</entry></row>
<row><entry align="right"><parameter>callback_type</parameter>&nbsp;:</entry>
<entry> 1 if the callback function of <parameter>entry</parameter> is of type
   <link linkend="GtkItemFactoryCallback1">GtkItemFactoryCallback1</link>, 2 if it is of type <link linkend="GtkItemFactoryCallback2">GtkItemFactoryCallback2</link> 
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-item-factory-create-items">gtk_item_factory_create_items ()</title>
<programlisting>void        gtk_item_factory_create_items   (<link linkend="GtkItemFactory">GtkItemFactory</link> *ifactory,
                                             <link linkend="guint">guint</link> n_entries,
                                             <link linkend="GtkItemFactoryEntry">GtkItemFactoryEntry</link> *entries,
                                             <link linkend="gpointer">gpointer</link> callback_data);</programlisting>
<para>
Creates the menu items from the <parameter>entries</parameter>.</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>ifactory</parameter>&nbsp;:</entry>
<entry> a <link linkend="GtkItemFactory">GtkItemFactory</link>
</entry></row>
<row><entry align="right"><parameter>n_entries</parameter>&nbsp;:</entry>
<entry> the length of <parameter>entries</parameter>
</entry></row>
<row><entry align="right"><parameter>entries</parameter>&nbsp;:</entry>
<entry> an array of <link linkend="GtkItemFactoryEntry">GtkItemFactoryEntry</link><!>s whose <parameter>callback</parameter> members
   must by of type <link linkend="GtkItemFactoryCallback1">GtkItemFactoryCallback1</link>
</entry></row>
<row><entry align="right"><parameter>callback_data</parameter>&nbsp;:</entry>
<entry> data passed to the callback functions of all entries
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-item-factory-create-items-ac">gtk_item_factory_create_items_ac ()</title>
<programlisting>void        gtk_item_factory_create_items_ac
                                            (<link linkend="GtkItemFactory">GtkItemFactory</link> *ifactory,
                                             <link linkend="guint">guint</link> n_entries,
                                             <link linkend="GtkItemFactoryEntry">GtkItemFactoryEntry</link> *entries,
                                             <link linkend="gpointer">gpointer</link> callback_data,
                                             <link linkend="guint">guint</link> callback_type);</programlisting>
<warning>
<para>
<literal>gtk_item_factory_create_items_ac</literal> is deprecated and should not be used in newly-written code.
</para>
</warning>
<para>
Creates the menu items from the <parameter>entries</parameter>.</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>ifactory</parameter>&nbsp;:</entry>
<entry> a <link linkend="GtkItemFactory">GtkItemFactory</link>
</entry></row>
<row><entry align="right"><parameter>n_entries</parameter>&nbsp;:</entry>
<entry> the length of <parameter>entries</parameter>
</entry></row>
<row><entry align="right"><parameter>entries</parameter>&nbsp;:</entry>
<entry> an array of <link linkend="GtkItemFactoryEntry">GtkItemFactoryEntry</link><!>s 
</entry></row>
<row><entry align="right"><parameter>callback_data</parameter>&nbsp;:</entry>
<entry> data passed to the callback functions of all entries
</entry></row>
<row><entry align="right"><parameter>callback_type</parameter>&nbsp;:</entry>
<entry> 1 if the callback functions in <parameter>entries</parameter> are of type
   <link linkend="GtkItemFactoryCallback1">GtkItemFactoryCallback1</link>, 2 if they are of type <link linkend="GtkItemFactoryCallback2">GtkItemFactoryCallback2</link> 
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-item-factory-delete-item">gtk_item_factory_delete_item ()</title>
<programlisting>void        gtk_item_factory_delete_item    (<link linkend="GtkItemFactory">GtkItemFactory</link> *ifactory,
                                             const <link linkend="gchar">gchar</link> *path);</programlisting>
<para>
Deletes the menu item which was created for <parameter>path</parameter> by the given
item factory.</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>ifactory</parameter>&nbsp;:</entry>
<entry> a <link linkend="GtkItemFactory">GtkItemFactory</link>
</entry></row>
<row><entry align="right"><parameter>path</parameter>&nbsp;:</entry>
<entry> a path
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-item-factory-delete-entry">gtk_item_factory_delete_entry ()</title>
<programlisting>void        gtk_item_factory_delete_entry   (<link linkend="GtkItemFactory">GtkItemFactory</link> *ifactory,
                                             <link linkend="GtkItemFactoryEntry">GtkItemFactoryEntry</link> *entry);</programlisting>
<para>
Deletes the menu item which was created from <parameter>entry</parameter> by the given
item factory.</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>ifactory</parameter>&nbsp;:</entry>
<entry> a <link linkend="GtkItemFactory">GtkItemFactory</link>
</entry></row>
<row><entry align="right"><parameter>entry</parameter>&nbsp;:</entry>
<entry> a <link linkend="GtkItemFactoryEntry">GtkItemFactoryEntry</link>
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-item-factory-delete-entries">gtk_item_factory_delete_entries ()</title>
<programlisting>void        gtk_item_factory_delete_entries (<link linkend="GtkItemFactory">GtkItemFactory</link> *ifactory,
                                             <link linkend="guint">guint</link> n_entries,
                                             <link linkend="GtkItemFactoryEntry">GtkItemFactoryEntry</link> *entries);</programlisting>
<para>
Deletes the menu items which were created from the <parameter>entries</parameter> by the given
item factory.</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>ifactory</parameter>&nbsp;:</entry>
<entry> a <link linkend="GtkItemFactory">GtkItemFactory</link>
</entry></row>
<row><entry align="right"><parameter>n_entries</parameter>&nbsp;:</entry>
<entry> the length of <parameter>entries</parameter>
</entry></row>
<row><entry align="right"><parameter>entries</parameter>&nbsp;:</entry>
<entry> an array of <link linkend="GtkItemFactoryEntry">GtkItemFactoryEntry</link><!>s 
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-item-factory-popup">gtk_item_factory_popup ()</title>
<programlisting>void        gtk_item_factory_popup          (<link linkend="GtkItemFactory">GtkItemFactory</link> *ifactory,
                                             <link linkend="guint">guint</link> x,
                                             <link linkend="guint">guint</link> y,
                                             <link linkend="guint">guint</link> mouse_button,
                                             <link linkend="guint32">guint32</link> time);</programlisting>
<para>
Pops up the menu constructed from the item factory at (<parameter>x</parameter>, <parameter>y</parameter>).</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>ifactory</parameter>&nbsp;:</entry>
<entry> a <link linkend="GtkItemFactory">GtkItemFactory</link> of type <link linkend="GTK-TYPE-MENU-CAPS">GTK_TYPE_MENU</link> (see <link linkend="gtk-item-factory-new">gtk_item_factory_new</link>())
</entry></row>
<row><entry align="right"><parameter>x</parameter>&nbsp;:</entry>
<entry> the x position 
</entry></row>
<row><entry align="right"><parameter>y</parameter>&nbsp;:</entry>
<entry> the y position
</entry></row>
<row><entry align="right"><parameter>mouse_button</parameter>&nbsp;:</entry>
<entry> the mouse button which was pressed to initiate this action
</entry></row>
<row><entry align="right"><parameter>time</parameter>&nbsp;:</entry>
<entry> a timestamp for this action
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-item-factory-popup-with-data">gtk_item_factory_popup_with_data ()</title>
<programlisting>void        gtk_item_factory_popup_with_data
                                            (<link linkend="GtkItemFactory">GtkItemFactory</link> *ifactory,
                                             <link linkend="gpointer">gpointer</link> popup_data,
                                             <link linkend="GtkDestroyNotify">GtkDestroyNotify</link> destroy,
                                             <link linkend="guint">guint</link> x,
                                             <link linkend="guint">guint</link> y,
                                             <link linkend="guint">guint</link> mouse_button,
                                             <link linkend="guint32">guint32</link> time);</programlisting>
<para>
Pops up the menu constructed from the item factory at (<parameter>x</parameter>, <parameter>y</parameter>). Callbacks
can access the <parameter>popup_data</parameter> while the menu is posted via 
<link linkend="gtk-item-factory-popup-data">gtk_item_factory_popup_data</link>() and <link linkend="gtk-item-factory-popup-data-from-widget">gtk_item_factory_popup_data_from_widget</link>().</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>ifactory</parameter>&nbsp;:</entry>
<entry> a <link linkend="GtkItemFactory">GtkItemFactory</link> of type <link linkend="GTK-TYPE-MENU-CAPS">GTK_TYPE_MENU</link> (see <link linkend="gtk-item-factory-new">gtk_item_factory_new</link>())
</entry></row>
<row><entry align="right"><parameter>popup_data</parameter>&nbsp;:</entry>
<entry> data available for callbacks while the menu is posted
</entry></row>
<row><entry align="right"><parameter>destroy</parameter>&nbsp;:</entry>
<entry> a <link linkend="GtkDestroyNotify">GtkDestroyNotify</link> function to be called on <parameter>popup_data</parameter> when
 the menu is unposted
</entry></row>
<row><entry align="right"><parameter>x</parameter>&nbsp;:</entry>
<entry> the x position 
</entry></row>
<row><entry align="right"><parameter>y</parameter>&nbsp;:</entry>
<entry> the y position
</entry></row>
<row><entry align="right"><parameter>mouse_button</parameter>&nbsp;:</entry>
<entry> the mouse button which was pressed to initiate this action
</entry></row>
<row><entry align="right"><parameter>time</parameter>&nbsp;:</entry>
<entry> a timestamp for this action
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-item-factory-popup-data">gtk_item_factory_popup_data ()</title>
<programlisting><link linkend="gpointer">gpointer</link>    gtk_item_factory_popup_data     (<link linkend="GtkItemFactory">GtkItemFactory</link> *ifactory);</programlisting>
<para>
Obtains the <parameter>popup_data</parameter> which was passed to 
<link linkend="gtk-item-factory-popup-with-data">gtk_item_factory_popup_with_data</link>(). This data is available until the menu
is popped down again.</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>ifactory</parameter>&nbsp;:</entry>
<entry> a <link linkend="GtkItemFactory">GtkItemFactory</link>
</entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry> <parameter>popup_data</parameter> associated with <parameter>ifactory</parameter>
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-item-factory-popup-data-from-widget">gtk_item_factory_popup_data_from_widget ()</title>
<programlisting><link linkend="gpointer">gpointer</link>    gtk_item_factory_popup_data_from_widget
                                            (<link linkend="GtkWidget">GtkWidget</link> *widget);</programlisting>
<para>
Obtains the <parameter>popup_data</parameter> which was passed to 
<link linkend="gtk-item-factory-popup-with-data">gtk_item_factory_popup_with_data</link>(). This data is available until the menu
is popped down again.</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>widget</parameter>&nbsp;:</entry>
<entry> a widget
</entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry> <parameter>popup_data</parameter> associated with the item factory from
  which <parameter>widget</parameter> was created, or <literal>NULL</literal> if <parameter>widget</parameter> wasn't created
  by an item factory
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-item-factory-from-path">gtk_item_factory_from_path ()</title>
<programlisting><link linkend="GtkItemFactory">GtkItemFactory</link>* gtk_item_factory_from_path  (const <link linkend="gchar">gchar</link> *path);</programlisting>
<warning>
<para>
<literal>gtk_item_factory_from_path</literal> is deprecated and should not be used in newly-written code.
</para>
</warning>
<para>
Finds an item factory which has been constructed using the 
<literal>"&lt;name&gt;"</literal> prefix of <parameter>path</parameter> as the <parameter>path</parameter> argument 
for <link linkend="gtk-item-factory-new">gtk_item_factory_new</link>().</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>path</parameter>&nbsp;:</entry>
<entry> a string starting with a factory path of the form 
  <literal>"&lt;name&gt;"</literal>
</entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry> the <link linkend="GtkItemFactory">GtkItemFactory</link> created for the given factory path, or <literal>NULL</literal> 
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-item-factory-create-menu-entries">gtk_item_factory_create_menu_entries ()</title>
<programlisting>void        gtk_item_factory_create_menu_entries
                                            (<link linkend="guint">guint</link> n_entries,
                                             <link linkend="GtkMenuEntry">GtkMenuEntry</link> *entries);</programlisting>
<warning>
<para>
<literal>gtk_item_factory_create_menu_entries</literal> is deprecated and should not be used in newly-written code.
</para>
</warning>
<para>
Creates the menu items from the <parameter>entries</parameter>.</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>n_entries</parameter>&nbsp;:</entry>
<entry> the length of <parameter>entries</parameter>
</entry></row>
<row><entry align="right"><parameter>entries</parameter>&nbsp;:</entry>
<entry> an array of <link linkend="GtkMenuEntry">GtkMenuEntry</link><!>s 
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-item-factories-path-delete">gtk_item_factories_path_delete ()</title>
<programlisting>void        gtk_item_factories_path_delete  (const <link linkend="gchar">gchar</link> *ifactory_path,
                                             const <link linkend="gchar">gchar</link> *path);</programlisting>
<warning>
<para>
<literal>gtk_item_factories_path_delete</literal> is deprecated and should not be used in newly-written code.
</para>
</warning>
<para>
Deletes all widgets constructed from the specified path.</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>ifactory_path</parameter>&nbsp;:</entry>
<entry> a factory path to prepend to <parameter>path</parameter>. May be <literal>NULL</literal> if <parameter>path</parameter>
  starts with a factory path
</entry></row>
<row><entry align="right"><parameter>path</parameter>&nbsp;:</entry>
<entry> a path 
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-item-factory-set-translate-func">gtk_item_factory_set_translate_func ()</title>
<programlisting>void        gtk_item_factory_set_translate_func
                                            (<link linkend="GtkItemFactory">GtkItemFactory</link> *ifactory,
                                             <link linkend="GtkTranslateFunc">GtkTranslateFunc</link> func,
                                             <link linkend="gpointer">gpointer</link> data,
                                             <link linkend="GtkDestroyNotify">GtkDestroyNotify</link> notify);</programlisting>
<para>
Sets a function to be used for translating the path elements before they
are displayed.</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>ifactory</parameter>&nbsp;:</entry>
<entry> a <link linkend="GtkItemFactory">GtkItemFactory</link>
</entry></row>
<row><entry align="right"><parameter>func</parameter>&nbsp;:</entry>
<entry> the <link linkend="GtkTranslateFunc">GtkTranslateFunc</link> function to be used to translate path elements 
</entry></row>
<row><entry align="right"><parameter>data</parameter>&nbsp;:</entry>
<entry> data to pass to <parameter>func</parameter> and <parameter>notify</parameter>
</entry></row>
<row><entry align="right"><parameter>notify</parameter>&nbsp;:</entry>
<entry> a <link linkend="GtkDestroyNotify">GtkDestroyNotify</link> function to be called when <parameter>ifactory</parameter> is 
  destroyed and when the translation function is changed again
</entry></row>
</tbody></tgroup></informaltable></refsect2>

</refsect1>




</refentry>
