|
Server : Apache/2.2.17 (Unix) mod_ssl/2.2.17 OpenSSL/0.9.8e-fips-rhel5 DAV/2 PHP/5.2.17 System : Linux localhost 2.6.18-419.el5 #1 SMP Fri Feb 24 22:47:42 UTC 2017 x86_64 User : nobody ( 99) PHP Version : 5.2.17 Disable Function : NONE Directory : /usr/share/gtk-doc/html/gtk/ |
Upload File : |
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<title>GtkItemFactory</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.69.1">
<link rel="start" href="index.html" title="GTK+ Reference Manual">
<link rel="up" href="DeprecatedObjects.html" title="Deprecated">
<link rel="prev" href="GtkCombo.html" title="GtkCombo">
<link rel="next" href="GtkList.html" title="GtkList">
<meta name="generator" content="GTK-Doc V1.6 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
<link rel="part" href="gtk.html" title="Part I. GTK+ Overview">
<link rel="part" href="gtkbase.html" title="Part II. GTK+ Core Reference">
<link rel="part" href="gtkobjects.html" title="Part III. GTK+ Widgets and Objects">
<link rel="chapter" href="ch01.html" title="Object Hierarchy">
<link rel="chapter" href="ch02.html" title="Widget Gallery">
<link rel="chapter" href="WindowWidgets.html" title="Windows">
<link rel="chapter" href="DisplayWidgets.html" title="Display Widgets">
<link rel="chapter" href="ButtonWidgets.html" title="Buttons and Toggles">
<link rel="chapter" href="NumericEntry.html" title="Numeric/Text Data Entry">
<link rel="chapter" href="TextWidgetObjects.html" title="Multiline Text Editor">
<link rel="chapter" href="TreeWidgetObjects.html" title="Tree, List and Icon Grid Widgets">
<link rel="chapter" href="MenusAndCombos.html" title="Menus, Combo Box, Toolbar">
<link rel="chapter" href="Actions.html" title="Action-based menus and toolbars">
<link rel="chapter" href="SelectorWidgets.html" title="Selectors (File/Font/Color/Input Devices)">
<link rel="chapter" href="LayoutContainers.html" title="Layout Containers">
<link rel="chapter" href="Ornaments.html" title="Ornaments">
<link rel="chapter" href="ScrollingWidgets.html" title="Scrolling">
<link rel="chapter" href="Printing.html" title="Printing">
<link rel="chapter" href="MiscObjects.html" title="Miscellaneous">
<link rel="chapter" href="AbstractObjects.html" title="Abstract Base Classes">
<link rel="chapter" href="PlugSocket.html" title="Cross-process Embedding">
<link rel="chapter" href="SpecialObjects.html" title="Special-purpose features">
<link rel="chapter" href="RecentDocuments.html" title="Recently Used Documents">
<link rel="chapter" href="DeprecatedObjects.html" title="Deprecated">
<link rel="part" href="migrating.html" title="Part IV. Migrating from Previous Versions of GTK+">
<link rel="chapter" href="gtk-migrating-checklist.html" title="Migration Checklist">
<link rel="chapter" href="gtk-migrating-GtkFileChooser.html" title="Migrating from GtkFileSelection to GtkFileChooser">
<link rel="chapter" href="gtk-migrating-GtkAction.html" title="Migrating from old menu and toolbar systems to GtkAction">
<link rel="chapter" href="gtk-migrating-GtkComboBox.html" title="Migrating from GtkOptionMenu and GtkCombo to GtkComboBox and
GtkComboBoxEntry">
<link rel="chapter" href="gtk-migrating-GtkIconView.html" title="Migrating from GnomeIconList to GtkIconView">
<link rel="chapter" href="gtk-migrating-GtkAboutDialog.html" title="Migrating from GnomeAbout to GtkAboutDialog">
<link rel="chapter" href="gtk-migrating-GtkColorButton.html" title="Migrating from GnomeColorPicker to GtkColorButton">
<link rel="chapter" href="gtk-migrating-GtkAssistant.html" title="Migrating from GnomeDruid to GtkAssistant">
<link rel="chapter" href="gtk-migrating-GtkRecentChooser.html" title="Migrating from EggRecent to GtkRecentChooser">
<link rel="chapter" href="gtk-migrating-GtkLinkButton.html" title="Migrating from GnomeHRef to GtkLinkButton">
<link rel="part" href="pt05.html" title="Part V. GTK+ Tools">
<link rel="glossary" href="glossary.html" title="Glossary">
<link rel="index" href="ix01.html" title="Index">
<link rel="index" href="ix02.html" title="Index of deprecated symbols">
<link rel="index" href="ix03.html" title="Index of new symbols in 2.2">
<link rel="index" href="ix04.html" title="Index of new symbols in 2.4">
<link rel="index" href="ix05.html" title="Index of new symbols in 2.6">
<link rel="index" href="ix06.html" title="Index of new symbols in 2.8">
<link rel="index" href="ix07.html" title="Index of new symbols in 2.10">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
<tr valign="middle">
<td><a accesskey="p" href="GtkCombo.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
<td><a accesskey="u" href="DeprecatedObjects.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
<th width="100%" align="center">GTK+ Reference Manual</th>
<td><a accesskey="n" href="GtkList.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
</tr>
<tr><td colspan="5" class="shortcuts"><nobr><a href="#id3883888" class="shortcut">Top</a>
 | 
<a href="#id3884986" class="shortcut">Description</a>
 | 
<a href="#id3884947" class="shortcut">Object Hierarchy</a></nobr></td></tr>
</table>
<div class="refentry" lang="en">
<a name="GtkItemFactory"></a><div class="titlepage"></div>
<div class="refnamediv"><table width="100%"><tr>
<td valign="top">
<h2>
<a name="id3883888"></a><span class="refentrytitle">GtkItemFactory</span>
</h2>
<p>GtkItemFactory — A factory for menus</p>
</td>
<td valign="top" align="right"></td>
</tr></table></div>
<div class="refsynopsisdiv">
<h2>Synopsis</h2>
<pre class="synopsis">
#include <gtk/gtk.h>
<a href="GtkItemFactory.html#GtkItemFactory-struct">GtkItemFactory</a>;
void (<a href="GtkItemFactory.html#GtkPrintFunc">*GtkPrintFunc</a>) (<a
href="../glib/glib-Basic-Types.html#gpointer"
>gpointer</a> func_data,
const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *str);
<a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a>* (<a href="GtkItemFactory.html#GtkTranslateFunc">*GtkTranslateFunc</a>) (const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *path,
<a
href="../glib/glib-Basic-Types.html#gpointer"
>gpointer</a> func_data);
void (<a href="GtkItemFactory.html#GtkItemFactoryCallback">*GtkItemFactoryCallback</a>) ();
void (<a href="GtkItemFactory.html#GtkItemFactoryCallback1">*GtkItemFactoryCallback1</a>) (<a
href="../glib/glib-Basic-Types.html#gpointer"
>gpointer</a> callback_data,
<a
href="../glib/glib-Basic-Types.html#guint"
>guint</a> callback_action,
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *widget);
void (<a href="GtkItemFactory.html#GtkItemFactoryCallback2">*GtkItemFactoryCallback2</a>) (<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *widget,
<a
href="../glib/glib-Basic-Types.html#gpointer"
>gpointer</a> callback_data,
<a
href="../glib/glib-Basic-Types.html#guint"
>guint</a> callback_action);
<a href="GtkItemFactory.html#GtkItemFactoryEntry">GtkItemFactoryEntry</a>;
<a href="GtkItemFactory.html#GtkItemFactoryItem">GtkItemFactoryItem</a>;
<a href="GtkItemFactory.html" title="GtkItemFactory">GtkItemFactory</a>* <a href="GtkItemFactory.html#gtk-item-factory-new">gtk_item_factory_new</a> (<a
href="../gobject/gobject-Type-Information.html#GType"
>GType</a> container_type,
const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *path,
<a href="gtk-Keyboard-Accelerators.html#GtkAccelGroup">GtkAccelGroup</a> *accel_group);
void <a href="GtkItemFactory.html#gtk-item-factory-construct">gtk_item_factory_construct</a> (<a href="GtkItemFactory.html" title="GtkItemFactory">GtkItemFactory</a> *ifactory,
<a
href="../gobject/gobject-Type-Information.html#GType"
>GType</a> container_type,
const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *path,
<a href="gtk-Keyboard-Accelerators.html#GtkAccelGroup">GtkAccelGroup</a> *accel_group);
void <a href="GtkItemFactory.html#gtk-item-factory-add-foreign">gtk_item_factory_add_foreign</a> (<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *accel_widget,
const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *full_path,
<a href="gtk-Keyboard-Accelerators.html#GtkAccelGroup">GtkAccelGroup</a> *accel_group,
<a
href="../glib/glib-Basic-Types.html#guint"
>guint</a> keyval,
<a
href="../gdk/gdk-Windows.html#GdkModifierType"
>GdkModifierType</a> modifiers);
<a href="GtkItemFactory.html" title="GtkItemFactory">GtkItemFactory</a>* <a href="GtkItemFactory.html#gtk-item-factory-from-widget">gtk_item_factory_from_widget</a>
(<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *widget);
const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a>* <a href="GtkItemFactory.html#gtk-item-factory-path-from-widget">gtk_item_factory_path_from_widget</a>
(<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *widget);
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a>* <a href="GtkItemFactory.html#gtk-item-factory-get-item">gtk_item_factory_get_item</a> (<a href="GtkItemFactory.html" title="GtkItemFactory">GtkItemFactory</a> *ifactory,
const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *path);
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a>* <a href="GtkItemFactory.html#gtk-item-factory-get-widget">gtk_item_factory_get_widget</a> (<a href="GtkItemFactory.html" title="GtkItemFactory">GtkItemFactory</a> *ifactory,
const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *path);
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a>* <a href="GtkItemFactory.html#gtk-item-factory-get-widget-by-action">gtk_item_factory_get_widget_by_action</a>
(<a href="GtkItemFactory.html" title="GtkItemFactory">GtkItemFactory</a> *ifactory,
<a
href="../glib/glib-Basic-Types.html#guint"
>guint</a> action);
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a>* <a href="GtkItemFactory.html#gtk-item-factory-get-item-by-action">gtk_item_factory_get_item_by_action</a>
(<a href="GtkItemFactory.html" title="GtkItemFactory">GtkItemFactory</a> *ifactory,
<a
href="../glib/glib-Basic-Types.html#guint"
>guint</a> action);
void <a href="GtkItemFactory.html#gtk-item-factory-create-item">gtk_item_factory_create_item</a> (<a href="GtkItemFactory.html" title="GtkItemFactory">GtkItemFactory</a> *ifactory,
<a href="GtkItemFactory.html#GtkItemFactoryEntry">GtkItemFactoryEntry</a> *entry,
<a
href="../glib/glib-Basic-Types.html#gpointer"
>gpointer</a> callback_data,
<a
href="../glib/glib-Basic-Types.html#guint"
>guint</a> callback_type);
void <a href="GtkItemFactory.html#gtk-item-factory-create-items">gtk_item_factory_create_items</a> (<a href="GtkItemFactory.html" title="GtkItemFactory">GtkItemFactory</a> *ifactory,
<a
href="../glib/glib-Basic-Types.html#guint"
>guint</a> n_entries,
<a href="GtkItemFactory.html#GtkItemFactoryEntry">GtkItemFactoryEntry</a> *entries,
<a
href="../glib/glib-Basic-Types.html#gpointer"
>gpointer</a> callback_data);
void <a href="GtkItemFactory.html#gtk-item-factory-create-items-ac">gtk_item_factory_create_items_ac</a>
(<a href="GtkItemFactory.html" title="GtkItemFactory">GtkItemFactory</a> *ifactory,
<a
href="../glib/glib-Basic-Types.html#guint"
>guint</a> n_entries,
<a href="GtkItemFactory.html#GtkItemFactoryEntry">GtkItemFactoryEntry</a> *entries,
<a
href="../glib/glib-Basic-Types.html#gpointer"
>gpointer</a> callback_data,
<a
href="../glib/glib-Basic-Types.html#guint"
>guint</a> callback_type);
void <a href="GtkItemFactory.html#gtk-item-factory-delete-item">gtk_item_factory_delete_item</a> (<a href="GtkItemFactory.html" title="GtkItemFactory">GtkItemFactory</a> *ifactory,
const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *path);
void <a href="GtkItemFactory.html#gtk-item-factory-delete-entry">gtk_item_factory_delete_entry</a> (<a href="GtkItemFactory.html" title="GtkItemFactory">GtkItemFactory</a> *ifactory,
<a href="GtkItemFactory.html#GtkItemFactoryEntry">GtkItemFactoryEntry</a> *entry);
void <a href="GtkItemFactory.html#gtk-item-factory-delete-entries">gtk_item_factory_delete_entries</a> (<a href="GtkItemFactory.html" title="GtkItemFactory">GtkItemFactory</a> *ifactory,
<a
href="../glib/glib-Basic-Types.html#guint"
>guint</a> n_entries,
<a href="GtkItemFactory.html#GtkItemFactoryEntry">GtkItemFactoryEntry</a> *entries);
void <a href="GtkItemFactory.html#gtk-item-factory-popup">gtk_item_factory_popup</a> (<a href="GtkItemFactory.html" title="GtkItemFactory">GtkItemFactory</a> *ifactory,
<a
href="../glib/glib-Basic-Types.html#guint"
>guint</a> x,
<a
href="../glib/glib-Basic-Types.html#guint"
>guint</a> y,
<a
href="../glib/glib-Basic-Types.html#guint"
>guint</a> mouse_button,
<a
href="../glib/glib-Basic-Types.html#guint32"
>guint32</a> time_);
void <a href="GtkItemFactory.html#gtk-item-factory-popup-with-data">gtk_item_factory_popup_with_data</a>
(<a href="GtkItemFactory.html" title="GtkItemFactory">GtkItemFactory</a> *ifactory,
<a
href="../glib/glib-Basic-Types.html#gpointer"
>gpointer</a> popup_data,
<a href="gtk-Types.html#GtkDestroyNotify">GtkDestroyNotify</a> destroy,
<a
href="../glib/glib-Basic-Types.html#guint"
>guint</a> x,
<a
href="../glib/glib-Basic-Types.html#guint"
>guint</a> y,
<a
href="../glib/glib-Basic-Types.html#guint"
>guint</a> mouse_button,
<a
href="../glib/glib-Basic-Types.html#guint32"
>guint32</a> time_);
<a
href="../glib/glib-Basic-Types.html#gpointer"
>gpointer</a> <a href="GtkItemFactory.html#gtk-item-factory-popup-data">gtk_item_factory_popup_data</a> (<a href="GtkItemFactory.html" title="GtkItemFactory">GtkItemFactory</a> *ifactory);
<a
href="../glib/glib-Basic-Types.html#gpointer"
>gpointer</a> <a href="GtkItemFactory.html#gtk-item-factory-popup-data-from-widget">gtk_item_factory_popup_data_from_widget</a>
(<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *widget);
<a href="GtkItemFactory.html" title="GtkItemFactory">GtkItemFactory</a>* <a href="GtkItemFactory.html#gtk-item-factory-from-path">gtk_item_factory_from_path</a> (const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *path);
void <a href="GtkItemFactory.html#gtk-item-factory-create-menu-entries">gtk_item_factory_create_menu_entries</a>
(<a
href="../glib/glib-Basic-Types.html#guint"
>guint</a> n_entries,
GtkMenuEntry *entries);
void <a href="GtkItemFactory.html#gtk-item-factories-path-delete">gtk_item_factories_path_delete</a> (const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *ifactory_path,
const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *path);
void <a href="GtkItemFactory.html#gtk-item-factory-set-translate-func">gtk_item_factory_set_translate_func</a>
(<a href="GtkItemFactory.html" title="GtkItemFactory">GtkItemFactory</a> *ifactory,
<a href="GtkItemFactory.html#GtkTranslateFunc">GtkTranslateFunc</a> func,
<a
href="../glib/glib-Basic-Types.html#gpointer"
>gpointer</a> data,
<a href="gtk-Types.html#GtkDestroyNotify">GtkDestroyNotify</a> notify);
</pre>
</div>
<div class="refsect1" lang="en">
<a name="id3884947"></a><h2>Object Hierarchy</h2>
<pre class="synopsis">
<a
href="../gobject/gobject-The-Base-Object-Type.html#GObject"
>GObject</a>
+----<a
href="../gobject/gobject-The-Base-Object-Type.html#GInitiallyUnowned"
>GInitiallyUnowned</a>
+----<a href="GtkObject.html" title="GtkObject">GtkObject</a>
+----GtkItemFactory
</pre>
</div>
<div class="refsect1" lang="en">
<a name="id3884986"></a><h2>Description</h2>
<p>
As of GTK+ 2.4, <a href="GtkItemFactory.html" title="GtkItemFactory"><span class="type">GtkItemFactory</span></a> has been deprecated in favour of <a href="GtkUIManager.html" title="GtkUIManager"><span class="type">GtkUIManager</span></a>.
</p>
</div>
<div class="refsect1" lang="en">
<a name="id3885018"></a><h2>Details</h2>
<div class="refsect2" lang="en">
<a name="id3885028"></a><h3>
<a name="GtkItemFactory-struct"></a>GtkItemFactory</h3>
<a class="indexterm" name="id3885042"></a><pre class="programlisting">typedef struct _GtkItemFactory GtkItemFactory;</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">GtkItemFactory</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3885070"></a><h3>
<a name="GtkPrintFunc"></a>GtkPrintFunc ()</h3>
<a class="indexterm" name="id3885084"></a><pre class="programlisting">void (*GtkPrintFunc) (<a
href="../glib/glib-Basic-Types.html#gpointer"
>gpointer</a> func_data,
const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *str);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">GtkPrintFunc</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>func_data</code></em> :</span></td>
<td>
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>str</code></em> :</span></td>
<td>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3885164"></a><h3>
<a name="GtkTranslateFunc"></a>GtkTranslateFunc ()</h3>
<a class="indexterm" name="id3885177"></a><pre class="programlisting"><a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a>* (*GtkTranslateFunc) (const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *path,
<a
href="../glib/glib-Basic-Types.html#gpointer"
>gpointer</a> func_data);</pre>
<p>
The function used to translate messages in e.g. <a href="gtk-Themeable-Stock-Images.html#GtkIconFactory"><span class="type">GtkIconFactory</span></a>
and <a href="GtkActionGroup.html" title="GtkActionGroup"><span class="type">GtkActionGroup</span></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>path</code></em> :</span></td>
<td>The id of the message. In <a href="GtkItemFactory.html" title="GtkItemFactory"><span class="type">GtkItemFactory</span></a> this will be a path
from a <a href="GtkItemFactory.html#GtkItemFactoryEntry"><span class="type">GtkItemFactoryEntry</span></a>, in <a href="GtkActionGroup.html" title="GtkActionGroup"><span class="type">GtkActionGroup</span></a>, it will be a label
or tooltip from a <a href="GtkActionGroup.html#GtkActionEntry"><span class="type">GtkActionEntry</span></a>.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>func_data</code></em> :</span></td>
<td>user data passed in when registering the function
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>the translated message
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3885308"></a><h3>
<a name="GtkItemFactoryCallback"></a>GtkItemFactoryCallback ()</h3>
<a class="indexterm" name="id3885323"></a><pre class="programlisting">void (*GtkItemFactoryCallback) ();</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">GtkItemFactoryCallback</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3885357"></a><h3>
<a name="GtkItemFactoryCallback1"></a>GtkItemFactoryCallback1 ()</h3>
<a class="indexterm" name="id3885372"></a><pre class="programlisting">void (*GtkItemFactoryCallback1) (<a
href="../glib/glib-Basic-Types.html#gpointer"
>gpointer</a> callback_data,
<a
href="../glib/glib-Basic-Types.html#guint"
>guint</a> callback_action,
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *widget);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">GtkItemFactoryCallback1</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>callback_data</code></em> :</span></td>
<td>
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>callback_action</code></em> :</span></td>
<td>
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>widget</code></em> :</span></td>
<td>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3885474"></a><h3>
<a name="GtkItemFactoryCallback2"></a>GtkItemFactoryCallback2 ()</h3>
<a class="indexterm" name="id3885490"></a><pre class="programlisting">void (*GtkItemFactoryCallback2) (<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *widget,
<a
href="../glib/glib-Basic-Types.html#gpointer"
>gpointer</a> callback_data,
<a
href="../glib/glib-Basic-Types.html#guint"
>guint</a> callback_action);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">GtkItemFactoryCallback2</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>widget</code></em> :</span></td>
<td>
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>callback_data</code></em> :</span></td>
<td>
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>callback_action</code></em> :</span></td>
<td>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3885591"></a><h3>
<a name="GtkItemFactoryEntry"></a>GtkItemFactoryEntry</h3>
<a class="indexterm" name="id3885606"></a><pre class="programlisting">typedef struct {
gchar *path;
gchar *accelerator;
GtkItemFactoryCallback callback;
guint callback_action;
/* possible values:
* NULL -> "<Item>"
* "" -> "<Item>"
* "<Title>" -> create a title item
* "<Item>" -> create a simple item
* "<ImageItem>" -> create an item holding an image
* "<StockItem>" -> create an item holding a stock image
* "<CheckItem>" -> create a check item
* "<ToggleItem>" -> create a toggle item
* "<RadioItem>" -> create a radio item
* <path> -> path of a radio item to link against
* "<Separator>" -> create a separator
* "<Tearoff>" -> create a tearoff separator
* "<Branch>" -> create an item to hold sub items
* "<LastBranch>" -> create a right justified item to hold sub items
*/
gchar *item_type;
/* Extra data for some item types:
* ImageItem -> pointer to inlined pixbuf stream
* StockItem -> name of stock item
*/
gconstpointer extra_data;
} GtkItemFactoryEntry;
</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">GtkItemFactoryEntry</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3885658"></a><h3>
<a name="GtkItemFactoryItem"></a>GtkItemFactoryItem</h3>
<a class="indexterm" name="id3885674"></a><pre class="programlisting">typedef struct {
gchar *path;
GSList *widgets;
} GtkItemFactoryItem;
</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">GtkItemFactoryItem</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3885702"></a><h3>
<a name="gtk-item-factory-new"></a>gtk_item_factory_new ()</h3>
<a class="indexterm" name="id3885718"></a><pre class="programlisting"><a href="GtkItemFactory.html" title="GtkItemFactory">GtkItemFactory</a>* gtk_item_factory_new (<a
href="../gobject/gobject-Type-Information.html#GType"
>GType</a> container_type,
const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *path,
<a href="gtk-Keyboard-Accelerators.html#GtkAccelGroup">GtkAccelGroup</a> *accel_group);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_item_factory_new</code> has been deprecated since version 2.4 and should not be used in newly-written code. </p>
</div>
<p>
Creates a new <a href="GtkItemFactory.html" title="GtkItemFactory"><span class="type">GtkItemFactory</span></a>.
</p>
<p>
Beware that the returned object does not have a floating reference.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>container_type</code></em> :</span></td>
<td> the kind of menu to create; can be
<span class="type">GTK_TYPE_MENU_BAR</span>, <span class="type">GTK_TYPE_MENU</span> or <span class="type">GTK_TYPE_OPTION_MENU</span>
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>path</code></em> :</span></td>
<td> the factory path of the new item factory, a string of the form
<code class="literal">"<name>"</code>
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>accel_group</code></em> :</span></td>
<td> a <a href="gtk-Keyboard-Accelerators.html#GtkAccelGroup"><span class="type">GtkAccelGroup</span></a> to which the accelerators for the
menu items will be added, or <a
href="../glib/glib-Standard-Macros.html#NULL:CAPS"
><code class="literal">NULL</code></a> to create a new one
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> a new <a href="GtkItemFactory.html" title="GtkItemFactory"><span class="type">GtkItemFactory</span></a>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3885911"></a><h3>
<a name="gtk-item-factory-construct"></a>gtk_item_factory_construct ()</h3>
<a class="indexterm" name="id3885928"></a><pre class="programlisting">void gtk_item_factory_construct (<a href="GtkItemFactory.html" title="GtkItemFactory">GtkItemFactory</a> *ifactory,
<a
href="../gobject/gobject-Type-Information.html#GType"
>GType</a> container_type,
const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *path,
<a href="gtk-Keyboard-Accelerators.html#GtkAccelGroup">GtkAccelGroup</a> *accel_group);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_item_factory_construct</code> has been deprecated since version 2.4 and should not be used in newly-written code. </p>
</div>
<p>
Initializes an item factory.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>ifactory</code></em> :</span></td>
<td> a <a href="GtkItemFactory.html" title="GtkItemFactory"><span class="type">GtkItemFactory</span></a>
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>container_type</code></em> :</span></td>
<td> the kind of menu to create; can be
<span class="type">GTK_TYPE_MENU_BAR</span>, <span class="type">GTK_TYPE_MENU</span> or <span class="type">GTK_TYPE_OPTION_MENU</span>
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>path</code></em> :</span></td>
<td> the factory path of <em class="parameter"><code>ifactory</code></em>, a string of the form
<code class="literal">"<name>"</code>
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>accel_group</code></em> :</span></td>
<td> a <a href="gtk-Keyboard-Accelerators.html#GtkAccelGroup"><span class="type">GtkAccelGroup</span></a> to which the accelerators for the
menu items will be added, or <a
href="../glib/glib-Standard-Macros.html#NULL:CAPS"
><code class="literal">NULL</code></a> to create a new one
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3886122"></a><h3>
<a name="gtk-item-factory-add-foreign"></a>gtk_item_factory_add_foreign ()</h3>
<a class="indexterm" name="id3886138"></a><pre class="programlisting">void gtk_item_factory_add_foreign (<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *accel_widget,
const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *full_path,
<a href="gtk-Keyboard-Accelerators.html#GtkAccelGroup">GtkAccelGroup</a> *accel_group,
<a
href="../glib/glib-Basic-Types.html#guint"
>guint</a> keyval,
<a
href="../gdk/gdk-Windows.html#GdkModifierType"
>GdkModifierType</a> modifiers);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_item_factory_add_foreign</code> has been deprecated since version 2.4 and should not be used in newly-written code. The recommended API for this purpose are the functions
<a href="GtkMenuItem.html#gtk-menu-item-set-accel-path"><code class="function">gtk_menu_item_set_accel_path()</code></a> and <a href="GtkWidget.html#gtk-widget-set-accel-path"><code class="function">gtk_widget_set_accel_path()</code></a>; don't
use <a href="GtkItemFactory.html#gtk-item-factory-add-foreign"><code class="function">gtk_item_factory_add_foreign()</code></a> in new code, since it is likely to
be removed in the future.</p>
</div>
<p>
Installs an accelerator for <em class="parameter"><code>accel_widget</code></em> in <em class="parameter"><code>accel_group</code></em>, that causes
the ::activate signal to be emitted if the accelerator is activated.
</p>
<p>
This function can be used to make widgets participate in the accel
saving/restoring functionality provided by <a href="gtk-Accelerator-Maps.html#gtk-accel-map-save"><code class="function">gtk_accel_map_save()</code></a> and
<a href="gtk-Accelerator-Maps.html#gtk-accel-map-load"><code class="function">gtk_accel_map_load()</code></a>, even if they haven't been created by an item
factory.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>accel_widget</code></em> :</span></td>
<td> widget to install an accelerator on
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>full_path</code></em> :</span></td>
<td> the full path for the <em class="parameter"><code>accel_widget</code></em>
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>accel_group</code></em> :</span></td>
<td> the accelerator group to install the accelerator in
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>keyval</code></em> :</span></td>
<td> key value of the accelerator
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>modifiers</code></em> :</span></td>
<td> modifier combination of the accelerator
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3886374"></a><h3>
<a name="gtk-item-factory-from-widget"></a>gtk_item_factory_from_widget ()</h3>
<a class="indexterm" name="id3886390"></a><pre class="programlisting"><a href="GtkItemFactory.html" title="GtkItemFactory">GtkItemFactory</a>* gtk_item_factory_from_widget
(<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *widget);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_item_factory_from_widget</code> is deprecated and should not be used in newly-written code. 2.4</p>
</div>
<p>
Obtains the item factory from which a widget was created.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>widget</code></em> :</span></td>
<td> a widget
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> the item factory from which <em class="parameter"><code>widget</code></em> was created, or <a
href="../glib/glib-Standard-Macros.html#NULL:CAPS"
><code class="literal">NULL</code></a>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3886481"></a><h3>
<a name="gtk-item-factory-path-from-widget"></a>gtk_item_factory_path_from_widget ()</h3>
<a class="indexterm" name="id3886498"></a><pre class="programlisting">const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a>* gtk_item_factory_path_from_widget
(<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *widget);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_item_factory_path_from_widget</code> has been deprecated since version 2.4 and should not be used in newly-written code. </p>
</div>
<p>
If <em class="parameter"><code>widget</code></em> 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 <a href="GtkItemFactory.html#gtk-item-factory-new"><code class="function">gtk_item_factory_new()</code></a> with the path specified in the
<a href="GtkItemFactory.html#GtkItemFactoryEntry"><span class="type">GtkItemFactoryEntry</span></a> from which the widget was created.)</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>widget</code></em> :</span></td>
<td> a widget
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> the full path to <em class="parameter"><code>widget</code></em> if it has been created by an item
factory, <a
href="../glib/glib-Standard-Macros.html#NULL:CAPS"
><code class="literal">NULL</code></a> otherwise. This value is owned by GTK+ and must not be
modified or freed.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3886620"></a><h3>
<a name="gtk-item-factory-get-item"></a>gtk_item_factory_get_item ()</h3>
<a class="indexterm" name="id3886637"></a><pre class="programlisting"><a href="GtkWidget.html" title="GtkWidget">GtkWidget</a>* gtk_item_factory_get_item (<a href="GtkItemFactory.html" title="GtkItemFactory">GtkItemFactory</a> *ifactory,
const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *path);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_item_factory_get_item</code> has been deprecated since version 2.4 and should not be used in newly-written code. </p>
</div>
<p>
Obtains the menu item which corresponds to <em class="parameter"><code>path</code></em>.
</p>
<p>
If the widget corresponding to <em class="parameter"><code>path</code></em> is a menu item which opens a
submenu, then the item is returned. If you are interested in the submenu,
use <a href="GtkItemFactory.html#gtk-item-factory-get-widget"><code class="function">gtk_item_factory_get_widget()</code></a> instead.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>ifactory</code></em> :</span></td>
<td> a <a href="GtkItemFactory.html" title="GtkItemFactory"><span class="type">GtkItemFactory</span></a>
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>path</code></em> :</span></td>
<td> the path to the menu item
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> the menu item for the given path, or <a
href="../glib/glib-Standard-Macros.html#NULL:CAPS"
><code class="literal">NULL</code></a> if <em class="parameter"><code>path</code></em> doesn't
lead to a menu item
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3886786"></a><h3>
<a name="gtk-item-factory-get-widget"></a>gtk_item_factory_get_widget ()</h3>
<a class="indexterm" name="id3886802"></a><pre class="programlisting"><a href="GtkWidget.html" title="GtkWidget">GtkWidget</a>* gtk_item_factory_get_widget (<a href="GtkItemFactory.html" title="GtkItemFactory">GtkItemFactory</a> *ifactory,
const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *path);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_item_factory_get_widget</code> has been deprecated since version 2.4 and should not be used in newly-written code. </p>
</div>
<p>
Obtains the widget which corresponds to <em class="parameter"><code>path</code></em>.
</p>
<p>
If the widget corresponding to <em class="parameter"><code>path</code></em> is a menu item which opens a
submenu, then the submenu is returned. If you are interested in the menu
item, use <a href="GtkItemFactory.html#gtk-item-factory-get-item"><code class="function">gtk_item_factory_get_item()</code></a> instead.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>ifactory</code></em> :</span></td>
<td> a <a href="GtkItemFactory.html" title="GtkItemFactory"><span class="type">GtkItemFactory</span></a>
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>path</code></em> :</span></td>
<td> the path to the widget
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> the widget for the given path, or <a
href="../glib/glib-Standard-Macros.html#NULL:CAPS"
><code class="literal">NULL</code></a> if <em class="parameter"><code>path</code></em> doesn't lead
to a widget
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3886951"></a><h3>
<a name="gtk-item-factory-get-widget-by-action"></a>gtk_item_factory_get_widget_by_action ()</h3>
<a class="indexterm" name="id3886968"></a><pre class="programlisting"><a href="GtkWidget.html" title="GtkWidget">GtkWidget</a>* gtk_item_factory_get_widget_by_action
(<a href="GtkItemFactory.html" title="GtkItemFactory">GtkItemFactory</a> *ifactory,
<a
href="../glib/glib-Basic-Types.html#guint"
>guint</a> action);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_item_factory_get_widget_by_action</code> has been deprecated since version 2.4 and should not be used in newly-written code. </p>
</div>
<p>
Obtains the widget which was constructed from the <a href="GtkItemFactory.html#GtkItemFactoryEntry"><span class="type">GtkItemFactoryEntry</span></a>
with the given <em class="parameter"><code>action</code></em>.
</p>
<p>
If there are multiple items with the same action, the result is
undefined.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>ifactory</code></em> :</span></td>
<td> a <a href="GtkItemFactory.html" title="GtkItemFactory"><span class="type">GtkItemFactory</span></a>
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>action</code></em> :</span></td>
<td> an action as specified in the <em class="parameter"><code>callback_action</code></em> field
of <a href="GtkItemFactory.html#GtkItemFactoryEntry"><span class="type">GtkItemFactoryEntry</span></a>
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> the widget which corresponds to the given action, or <a
href="../glib/glib-Standard-Macros.html#NULL:CAPS"
><code class="literal">NULL</code></a>
if no widget was found
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3887118"></a><h3>
<a name="gtk-item-factory-get-item-by-action"></a>gtk_item_factory_get_item_by_action ()</h3>
<a class="indexterm" name="id3887134"></a><pre class="programlisting"><a href="GtkWidget.html" title="GtkWidget">GtkWidget</a>* gtk_item_factory_get_item_by_action
(<a href="GtkItemFactory.html" title="GtkItemFactory">GtkItemFactory</a> *ifactory,
<a
href="../glib/glib-Basic-Types.html#guint"
>guint</a> action);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_item_factory_get_item_by_action</code> has been deprecated since version 2.4 and should not be used in newly-written code. </p>
</div>
<p>
Obtains the menu item which was constructed from the first
<a href="GtkItemFactory.html#GtkItemFactoryEntry"><span class="type">GtkItemFactoryEntry</span></a> with the given <em class="parameter"><code>action</code></em>.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>ifactory</code></em> :</span></td>
<td> a <a href="GtkItemFactory.html" title="GtkItemFactory"><span class="type">GtkItemFactory</span></a>
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>action</code></em> :</span></td>
<td> an action as specified in the <em class="parameter"><code>callback_action</code></em> field
of <a href="GtkItemFactory.html#GtkItemFactoryEntry"><span class="type">GtkItemFactoryEntry</span></a>
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> the menu item which corresponds to the given action, or <a
href="../glib/glib-Standard-Macros.html#NULL:CAPS"
><code class="literal">NULL</code></a>
if no menu item was found
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3887279"></a><h3>
<a name="gtk-item-factory-create-item"></a>gtk_item_factory_create_item ()</h3>
<a class="indexterm" name="id3887295"></a><pre class="programlisting">void gtk_item_factory_create_item (<a href="GtkItemFactory.html" title="GtkItemFactory">GtkItemFactory</a> *ifactory,
<a href="GtkItemFactory.html#GtkItemFactoryEntry">GtkItemFactoryEntry</a> *entry,
<a
href="../glib/glib-Basic-Types.html#gpointer"
>gpointer</a> callback_data,
<a
href="../glib/glib-Basic-Types.html#guint"
>guint</a> callback_type);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_item_factory_create_item</code> has been deprecated since version 2.4 and should not be used in newly-written code. </p>
</div>
<p>
Creates an item for <em class="parameter"><code>entry</code></em>.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>ifactory</code></em> :</span></td>
<td> a <a href="GtkItemFactory.html" title="GtkItemFactory"><span class="type">GtkItemFactory</span></a>
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>entry</code></em> :</span></td>
<td> the <a href="GtkItemFactory.html#GtkItemFactoryEntry"><span class="type">GtkItemFactoryEntry</span></a> to create an item for
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>callback_data</code></em> :</span></td>
<td> data passed to the callback function of <em class="parameter"><code>entry</code></em>
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>callback_type</code></em> :</span></td>
<td> 1 if the callback function of <em class="parameter"><code>entry</code></em> is of type
<a href="GtkItemFactory.html#GtkItemFactoryCallback1"><span class="type">GtkItemFactoryCallback1</span></a>, 2 if it is of type <a href="GtkItemFactory.html#GtkItemFactoryCallback2"><span class="type">GtkItemFactoryCallback2</span></a>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3887477"></a><h3>
<a name="gtk-item-factory-create-items"></a>gtk_item_factory_create_items ()</h3>
<a class="indexterm" name="id3887493"></a><pre class="programlisting">void gtk_item_factory_create_items (<a href="GtkItemFactory.html" title="GtkItemFactory">GtkItemFactory</a> *ifactory,
<a
href="../glib/glib-Basic-Types.html#guint"
>guint</a> n_entries,
<a href="GtkItemFactory.html#GtkItemFactoryEntry">GtkItemFactoryEntry</a> *entries,
<a
href="../glib/glib-Basic-Types.html#gpointer"
>gpointer</a> callback_data);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_item_factory_create_items</code> has been deprecated since version 2.4 and should not be used in newly-written code. </p>
</div>
<p>
Creates the menu items from the <em class="parameter"><code>entries</code></em>.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>ifactory</code></em> :</span></td>
<td> a <a href="GtkItemFactory.html" title="GtkItemFactory"><span class="type">GtkItemFactory</span></a>
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>n_entries</code></em> :</span></td>
<td> the length of <em class="parameter"><code>entries</code></em>
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>entries</code></em> :</span></td>
<td> an array of <a href="GtkItemFactory.html#GtkItemFactoryEntry"><span class="type">GtkItemFactoryEntry</span></a>s whose <em class="parameter"><code>callback</code></em> members
must by of type <a href="GtkItemFactory.html#GtkItemFactoryCallback1"><span class="type">GtkItemFactoryCallback1</span></a>
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>callback_data</code></em> :</span></td>
<td> data passed to the callback functions of all entries
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3887667"></a><h3>
<a name="gtk-item-factory-create-items-ac"></a>gtk_item_factory_create_items_ac ()</h3>
<a class="indexterm" name="id3887683"></a><pre class="programlisting">void gtk_item_factory_create_items_ac
(<a href="GtkItemFactory.html" title="GtkItemFactory">GtkItemFactory</a> *ifactory,
<a
href="../glib/glib-Basic-Types.html#guint"
>guint</a> n_entries,
<a href="GtkItemFactory.html#GtkItemFactoryEntry">GtkItemFactoryEntry</a> *entries,
<a
href="../glib/glib-Basic-Types.html#gpointer"
>gpointer</a> callback_data,
<a
href="../glib/glib-Basic-Types.html#guint"
>guint</a> callback_type);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_item_factory_create_items_ac</code> has been deprecated since version 2.4 and should not be used in newly-written code. </p>
</div>
<p>
Creates the menu items from the <em class="parameter"><code>entries</code></em>.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>ifactory</code></em> :</span></td>
<td> a <a href="GtkItemFactory.html" title="GtkItemFactory"><span class="type">GtkItemFactory</span></a>
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>n_entries</code></em> :</span></td>
<td> the length of <em class="parameter"><code>entries</code></em>
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>entries</code></em> :</span></td>
<td> an array of <a href="GtkItemFactory.html#GtkItemFactoryEntry"><span class="type">GtkItemFactoryEntry</span></a>s
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>callback_data</code></em> :</span></td>
<td> data passed to the callback functions of all entries
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>callback_type</code></em> :</span></td>
<td> 1 if the callback functions in <em class="parameter"><code>entries</code></em> are of type
<a href="GtkItemFactory.html#GtkItemFactoryCallback1"><span class="type">GtkItemFactoryCallback1</span></a>, 2 if they are of type <a href="GtkItemFactory.html#GtkItemFactoryCallback2"><span class="type">GtkItemFactoryCallback2</span></a>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3887889"></a><h3>
<a name="gtk-item-factory-delete-item"></a>gtk_item_factory_delete_item ()</h3>
<a class="indexterm" name="id3887905"></a><pre class="programlisting">void gtk_item_factory_delete_item (<a href="GtkItemFactory.html" title="GtkItemFactory">GtkItemFactory</a> *ifactory,
const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *path);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_item_factory_delete_item</code> has been deprecated since version 2.4 and should not be used in newly-written code. </p>
</div>
<p>
Deletes the menu item which was created for <em class="parameter"><code>path</code></em> by the given
item factory.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>ifactory</code></em> :</span></td>
<td> a <a href="GtkItemFactory.html" title="GtkItemFactory"><span class="type">GtkItemFactory</span></a>
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>path</code></em> :</span></td>
<td> a path
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3888005"></a><h3>
<a name="gtk-item-factory-delete-entry"></a>gtk_item_factory_delete_entry ()</h3>
<a class="indexterm" name="id3888021"></a><pre class="programlisting">void gtk_item_factory_delete_entry (<a href="GtkItemFactory.html" title="GtkItemFactory">GtkItemFactory</a> *ifactory,
<a href="GtkItemFactory.html#GtkItemFactoryEntry">GtkItemFactoryEntry</a> *entry);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_item_factory_delete_entry</code> has been deprecated since version 2.4 and should not be used in newly-written code. </p>
</div>
<p>
Deletes the menu item which was created from <em class="parameter"><code>entry</code></em> by the given
item factory.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>ifactory</code></em> :</span></td>
<td> a <a href="GtkItemFactory.html" title="GtkItemFactory"><span class="type">GtkItemFactory</span></a>
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>entry</code></em> :</span></td>
<td> a <a href="GtkItemFactory.html#GtkItemFactoryEntry"><span class="type">GtkItemFactoryEntry</span></a>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3888129"></a><h3>
<a name="gtk-item-factory-delete-entries"></a>gtk_item_factory_delete_entries ()</h3>
<a class="indexterm" name="id3888145"></a><pre class="programlisting">void gtk_item_factory_delete_entries (<a href="GtkItemFactory.html" title="GtkItemFactory">GtkItemFactory</a> *ifactory,
<a
href="../glib/glib-Basic-Types.html#guint"
>guint</a> n_entries,
<a href="GtkItemFactory.html#GtkItemFactoryEntry">GtkItemFactoryEntry</a> *entries);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_item_factory_delete_entries</code> has been deprecated since version 2.4 and should not be used in newly-written code. </p>
</div>
<p>
Deletes the menu items which were created from the <em class="parameter"><code>entries</code></em> by the given
item factory.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>ifactory</code></em> :</span></td>
<td> a <a href="GtkItemFactory.html" title="GtkItemFactory"><span class="type">GtkItemFactory</span></a>
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>n_entries</code></em> :</span></td>
<td> the length of <em class="parameter"><code>entries</code></em>
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>entries</code></em> :</span></td>
<td> an array of <a href="GtkItemFactory.html#GtkItemFactoryEntry"><span class="type">GtkItemFactoryEntry</span></a>s
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3888282"></a><h3>
<a name="gtk-item-factory-popup"></a>gtk_item_factory_popup ()</h3>
<a class="indexterm" name="id3888298"></a><pre class="programlisting">void gtk_item_factory_popup (<a href="GtkItemFactory.html" title="GtkItemFactory">GtkItemFactory</a> *ifactory,
<a
href="../glib/glib-Basic-Types.html#guint"
>guint</a> x,
<a
href="../glib/glib-Basic-Types.html#guint"
>guint</a> y,
<a
href="../glib/glib-Basic-Types.html#guint"
>guint</a> mouse_button,
<a
href="../glib/glib-Basic-Types.html#guint32"
>guint32</a> time_);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_item_factory_popup</code> has been deprecated since version 2.4 and should not be used in newly-written code. </p>
</div>
<p>
Pops up the menu constructed from the item factory at (<em class="parameter"><code>x</code></em>, <em class="parameter"><code>y</code></em>).
</p>
<p>
The <em class="parameter"><code>mouse_button</code></em> parameter should be the mouse button pressed to initiate
the menu popup. If the menu popup was initiated by something other than
a mouse button press, such as a mouse button release or a keypress,
<em class="parameter"><code>mouse_button</code></em> should be 0.
</p>
<p>
The <em class="parameter"><code>time_</code></em> parameter should be the time stamp of the event that
initiated the popup. If such an event is not available, use
<a href="gtk-General.html#gtk-get-current-event-time"><code class="function">gtk_get_current_event_time()</code></a> instead.
</p>
<p>
The operation of the <em class="parameter"><code>mouse_button</code></em> and the <em class="parameter"><code>time_</code></em> parameter is the same
as the <em class="parameter"><code>button</code></em> and <em class="parameter"><code>activation_time</code></em> parameters for <a href="GtkMenu.html#gtk-menu-popup"><code class="function">gtk_menu_popup()</code></a>.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>ifactory</code></em> :</span></td>
<td> a <a href="GtkItemFactory.html" title="GtkItemFactory"><span class="type">GtkItemFactory</span></a> of type <span class="type">GTK_TYPE_MENU</span> (see <a href="GtkItemFactory.html#gtk-item-factory-new"><code class="function">gtk_item_factory_new()</code></a>)
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>x</code></em> :</span></td>
<td> the x position
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>y</code></em> :</span></td>
<td> the y position
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>mouse_button</code></em> :</span></td>
<td> the mouse button which was pressed to initiate the popup
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>time_</code></em> :</span></td>
<td> the time at which the activation event occurred
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3888568"></a><h3>
<a name="gtk-item-factory-popup-with-data"></a>gtk_item_factory_popup_with_data ()</h3>
<a class="indexterm" name="id3888584"></a><pre class="programlisting">void gtk_item_factory_popup_with_data
(<a href="GtkItemFactory.html" title="GtkItemFactory">GtkItemFactory</a> *ifactory,
<a
href="../glib/glib-Basic-Types.html#gpointer"
>gpointer</a> popup_data,
<a href="gtk-Types.html#GtkDestroyNotify">GtkDestroyNotify</a> destroy,
<a
href="../glib/glib-Basic-Types.html#guint"
>guint</a> x,
<a
href="../glib/glib-Basic-Types.html#guint"
>guint</a> y,
<a
href="../glib/glib-Basic-Types.html#guint"
>guint</a> mouse_button,
<a
href="../glib/glib-Basic-Types.html#guint32"
>guint32</a> time_);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_item_factory_popup_with_data</code> has been deprecated since version 2.4 and should not be used in newly-written code. </p>
</div>
<p>
Pops up the menu constructed from the item factory at (<em class="parameter"><code>x</code></em>, <em class="parameter"><code>y</code></em>). Callbacks
can access the <em class="parameter"><code>popup_data</code></em> while the menu is posted via
<a href="GtkItemFactory.html#gtk-item-factory-popup-data"><code class="function">gtk_item_factory_popup_data()</code></a> and <a href="GtkItemFactory.html#gtk-item-factory-popup-data-from-widget"><code class="function">gtk_item_factory_popup_data_from_widget()</code></a>.
</p>
<p>
The <em class="parameter"><code>mouse_button</code></em> parameter should be the mouse button pressed to initiate
the menu popup. If the menu popup was initiated by something other than
a mouse button press, such as a mouse button release or a keypress,
<em class="parameter"><code>mouse_button</code></em> should be 0.
</p>
<p>
The <em class="parameter"><code>time_</code></em> parameter should be the time stamp of the event that
initiated the popup. If such an event is not available, use
<a href="gtk-General.html#gtk-get-current-event-time"><code class="function">gtk_get_current_event_time()</code></a> instead.
</p>
<p>
The operation of the <em class="parameter"><code>mouse_button</code></em> and the <em class="parameter"><code>time_</code></em> parameters is the same
as the <em class="parameter"><code>button</code></em> and <em class="parameter"><code>activation_time</code></em> parameters for <a href="GtkMenu.html#gtk-menu-popup"><code class="function">gtk_menu_popup()</code></a>.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>ifactory</code></em> :</span></td>
<td> a <a href="GtkItemFactory.html" title="GtkItemFactory"><span class="type">GtkItemFactory</span></a> of type <span class="type">GTK_TYPE_MENU</span> (see <a href="GtkItemFactory.html#gtk-item-factory-new"><code class="function">gtk_item_factory_new()</code></a>)
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>popup_data</code></em> :</span></td>
<td> data available for callbacks while the menu is posted
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>destroy</code></em> :</span></td>
<td> a <a href="gtk-Types.html#GtkDestroyNotify"><span class="type">GtkDestroyNotify</span></a> function to be called on <em class="parameter"><code>popup_data</code></em> when
the menu is unposted
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>x</code></em> :</span></td>
<td> the x position
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>y</code></em> :</span></td>
<td> the y position
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>mouse_button</code></em> :</span></td>
<td> the mouse button which was pressed to initiate the popup
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>time_</code></em> :</span></td>
<td> the time at which the activation event occurred
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3888943"></a><h3>
<a name="gtk-item-factory-popup-data"></a>gtk_item_factory_popup_data ()</h3>
<a class="indexterm" name="id3888960"></a><pre class="programlisting"><a
href="../glib/glib-Basic-Types.html#gpointer"
>gpointer</a> gtk_item_factory_popup_data (<a href="GtkItemFactory.html" title="GtkItemFactory">GtkItemFactory</a> *ifactory);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_item_factory_popup_data</code> has been deprecated since version 2.4 and should not be used in newly-written code. </p>
</div>
<p>
Obtains the <em class="parameter"><code>popup_data</code></em> which was passed to
<a href="GtkItemFactory.html#gtk-item-factory-popup-with-data"><code class="function">gtk_item_factory_popup_with_data()</code></a>. This data is available until the menu
is popped down again.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>ifactory</code></em> :</span></td>
<td> a <a href="GtkItemFactory.html" title="GtkItemFactory"><span class="type">GtkItemFactory</span></a>
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> <em class="parameter"><code>popup_data</code></em> associated with <em class="parameter"><code>ifactory</code></em>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3889071"></a><h3>
<a name="gtk-item-factory-popup-data-from-widget"></a>gtk_item_factory_popup_data_from_widget ()</h3>
<a class="indexterm" name="id3889088"></a><pre class="programlisting"><a
href="../glib/glib-Basic-Types.html#gpointer"
>gpointer</a> gtk_item_factory_popup_data_from_widget
(<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *widget);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_item_factory_popup_data_from_widget</code> has been deprecated since version 2.4 and should not be used in newly-written code. </p>
</div>
<p>
Obtains the <em class="parameter"><code>popup_data</code></em> which was passed to
<a href="GtkItemFactory.html#gtk-item-factory-popup-with-data"><code class="function">gtk_item_factory_popup_with_data()</code></a>. This data is available until the menu
is popped down again.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>widget</code></em> :</span></td>
<td> a widget
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> <em class="parameter"><code>popup_data</code></em> associated with the item factory from
which <em class="parameter"><code>widget</code></em> was created, or <a
href="../glib/glib-Standard-Macros.html#NULL:CAPS"
><code class="literal">NULL</code></a> if <em class="parameter"><code>widget</code></em> wasn't created
by an item factory
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3889210"></a><h3>
<a name="gtk-item-factory-from-path"></a>gtk_item_factory_from_path ()</h3>
<a class="indexterm" name="id3889227"></a><pre class="programlisting"><a href="GtkItemFactory.html" title="GtkItemFactory">GtkItemFactory</a>* gtk_item_factory_from_path (const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *path);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_item_factory_from_path</code> has been deprecated since version 2.4 and should not be used in newly-written code. </p>
</div>
<p>
Finds an item factory which has been constructed using the
<code class="literal">"<name>"</code> prefix of <em class="parameter"><code>path</code></em> as the <em class="parameter"><code>path</code></em> argument
for <a href="GtkItemFactory.html#gtk-item-factory-new"><code class="function">gtk_item_factory_new()</code></a>.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>path</code></em> :</span></td>
<td> a string starting with a factory path of the form
<code class="literal">"<name>"</code>
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> the <a href="GtkItemFactory.html" title="GtkItemFactory"><span class="type">GtkItemFactory</span></a> created for the given factory path, or <a
href="../glib/glib-Standard-Macros.html#NULL:CAPS"
><code class="literal">NULL</code></a>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3889356"></a><h3>
<a name="gtk-item-factory-create-menu-entries"></a>gtk_item_factory_create_menu_entries ()</h3>
<a class="indexterm" name="id3889372"></a><pre class="programlisting">void gtk_item_factory_create_menu_entries
(<a
href="../glib/glib-Basic-Types.html#guint"
>guint</a> n_entries,
GtkMenuEntry *entries);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_item_factory_create_menu_entries</code> has been deprecated since version 2.4 and should not be used in newly-written code. </p>
</div>
<p>
Creates the menu items from the <em class="parameter"><code>entries</code></em>.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>n_entries</code></em> :</span></td>
<td> the length of <em class="parameter"><code>entries</code></em>
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>entries</code></em> :</span></td>
<td> an array of <span class="type">GtkMenuEntry</span>s
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3889480"></a><h3>
<a name="gtk-item-factories-path-delete"></a>gtk_item_factories_path_delete ()</h3>
<a class="indexterm" name="id3889496"></a><pre class="programlisting">void gtk_item_factories_path_delete (const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *ifactory_path,
const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *path);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_item_factories_path_delete</code> has been deprecated since version 2.4 and should not be used in newly-written code. </p>
</div>
<p>
Deletes all widgets constructed from the specified path.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>ifactory_path</code></em> :</span></td>
<td> a factory path to prepend to <em class="parameter"><code>path</code></em>. May be <a
href="../glib/glib-Standard-Macros.html#NULL:CAPS"
><code class="literal">NULL</code></a> if <em class="parameter"><code>path</code></em>
starts with a factory path
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>path</code></em> :</span></td>
<td> a path
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3889605"></a><h3>
<a name="gtk-item-factory-set-translate-func"></a>gtk_item_factory_set_translate_func ()</h3>
<a class="indexterm" name="id3889622"></a><pre class="programlisting">void gtk_item_factory_set_translate_func
(<a href="GtkItemFactory.html" title="GtkItemFactory">GtkItemFactory</a> *ifactory,
<a href="GtkItemFactory.html#GtkTranslateFunc">GtkTranslateFunc</a> func,
<a
href="../glib/glib-Basic-Types.html#gpointer"
>gpointer</a> data,
<a href="gtk-Types.html#GtkDestroyNotify">GtkDestroyNotify</a> notify);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_item_factory_set_translate_func</code> has been deprecated since version 2.4 and should not be used in newly-written code. </p>
</div>
<p>
Sets a function to be used for translating the path elements before they
are displayed.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>ifactory</code></em> :</span></td>
<td> a <a href="GtkItemFactory.html" title="GtkItemFactory"><span class="type">GtkItemFactory</span></a>
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>func</code></em> :</span></td>
<td> the <a href="GtkItemFactory.html#GtkTranslateFunc"><span class="type">GtkTranslateFunc</span></a> function to be used to translate path elements
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>data</code></em> :</span></td>
<td> data to pass to <em class="parameter"><code>func</code></em> and <em class="parameter"><code>notify</code></em>
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>notify</code></em> :</span></td>
<td> a <a href="gtk-Types.html#GtkDestroyNotify"><span class="type">GtkDestroyNotify</span></a> function to be called when <em class="parameter"><code>ifactory</code></em> is
destroyed and when the translation function is changed again
</td>
</tr>
</tbody>
</table></div>
</div>
</div>
</div>
</body>
</html>