File: //usr/local/ssl/share/gtk-doc/html/libgnomeui/libgnomeui-gnome-app-helper.html
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<title>gnome-app-helper</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.69.1">
<link rel="start" href="index.html" title="GNOME UI Library Reference Manual">
<link rel="up" href="application-mgmt.html" title="Application management">
<link rel="prev" href="GnomeAppBar.html" title="GnomeAppBar">
<link rel="next" href="libgnomeui-gnome-window.html" title="gnome-window">
<meta name="generator" content="GTK-Doc V1.7 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
<link rel="chapter" href="ch01.html" title="GNOME UI Library (libgnomeui)">
</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="GnomeAppBar.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
<td><a accesskey="u" href="application-mgmt.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">GNOME UI Library Reference Manual</th>
<td><a accesskey="n" href="libgnomeui-gnome-window.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="#id2931302" class="shortcut">Top</a>
 | 
<a href="#id2933277" class="shortcut">Description</a></nobr></td></tr>
</table>
<div class="refentry" lang="en">
<a name="libgnomeui-gnome-app-helper"></a><div class="titlepage"></div>
<div class="refnamediv"><table width="100%"><tr>
<td valign="top">
<h2>
<a name="id2931302"></a><span class="refentrytitle">gnome-app-helper</span>
</h2>
<p>gnome-app-helper — Useful functions for populating menus and toolbars.</p>
</td>
<td valign="top" align="right"></td>
</tr></table></div>
<div class="refsynopsisdiv">
<h2>Synopsis</h2>
<pre class="synopsis">
#include <libgnomeui/libgnomeui.h>
enum <a href="libgnomeui-gnome-app-helper.html#GnomeUIInfoType">GnomeUIInfoType</a>;
enum <a href="libgnomeui-gnome-app-helper.html#GnomeUIInfoConfigurableTypes">GnomeUIInfoConfigurableTypes</a>;
#define <a href="libgnomeui-gnome-app-helper.html#GNOME-APP-CONFIGURABLE-ITEM-EXIT:CAPS">GNOME_APP_CONFIGURABLE_ITEM_EXIT</a>
enum <a href="libgnomeui-gnome-app-helper.html#GnomeUIPixmapType">GnomeUIPixmapType</a>;
<a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo">GnomeUIInfo</a>;
<a href="libgnomeui-gnome-app-helper.html#GnomeUIBuilderData">GnomeUIBuilderData</a>;
#define <a href="libgnomeui-gnome-app-helper.html#GNOMEUIINFO-KEY-UIDATA:CAPS">GNOMEUIINFO_KEY_UIDATA</a>
#define <a href="libgnomeui-gnome-app-helper.html#GNOMEUIINFO-KEY-UIBDATA:CAPS">GNOMEUIINFO_KEY_UIBDATA</a>
void (<a href="libgnomeui-gnome-app-helper.html#GnomeUISignalConnectFunc">*GnomeUISignalConnectFunc</a>) (<a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo">GnomeUIInfo</a> *uiinfo,
const char *signal_name,
<a href="libgnomeui-gnome-app-helper.html#GnomeUIBuilderData">GnomeUIBuilderData</a> *uibdata);
void <a href="libgnomeui-gnome-app-helper.html#gnome-accelerators-sync">gnome_accelerators_sync</a> (void);
void <a href="libgnomeui-gnome-app-helper.html#gnome-app-fill-menu">gnome_app_fill_menu</a> (<a
href="/usr/share/gtk-doc/html/gtk/GtkMenuShell.html"
>GtkMenuShell</a> *menu_shell,
<a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo">GnomeUIInfo</a> *uiinfo,
<a
href="/usr/share/gtk-doc/html/gtk/gtk-Keyboard-Accelerators.html#GtkAccelGroup"
>GtkAccelGroup</a> *accel_group,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> uline_accels,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> pos);
void <a href="libgnomeui-gnome-app-helper.html#gnome-app-fill-menu-with-data">gnome_app_fill_menu_with_data</a> (<a
href="/usr/share/gtk-doc/html/gtk/GtkMenuShell.html"
>GtkMenuShell</a> *menu_shell,
<a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo">GnomeUIInfo</a> *uiinfo,
<a
href="/usr/share/gtk-doc/html/gtk/gtk-Keyboard-Accelerators.html#GtkAccelGroup"
>GtkAccelGroup</a> *accel_group,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> uline_accels,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> pos,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> user_data);
void <a href="libgnomeui-gnome-app-helper.html#gnome-app-fill-menu-custom">gnome_app_fill_menu_custom</a> (<a
href="/usr/share/gtk-doc/html/gtk/GtkMenuShell.html"
>GtkMenuShell</a> *menu_shell,
<a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo">GnomeUIInfo</a> *uiinfo,
<a href="libgnomeui-gnome-app-helper.html#GnomeUIBuilderData">GnomeUIBuilderData</a> *uibdata,
<a
href="/usr/share/gtk-doc/html/gtk/gtk-Keyboard-Accelerators.html#GtkAccelGroup"
>GtkAccelGroup</a> *accel_group,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> uline_accels,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> pos);
void <a href="libgnomeui-gnome-app-helper.html#gnome-app-ui-configure-configurable">gnome_app_ui_configure_configurable</a>
(<a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo">GnomeUIInfo</a> *uiinfo);
void <a href="libgnomeui-gnome-app-helper.html#gnome-app-create-menus">gnome_app_create_menus</a> (<a href="GnomeApp.html" title="GnomeApp">GnomeApp</a> *app,
<a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo">GnomeUIInfo</a> *uiinfo);
void <a href="libgnomeui-gnome-app-helper.html#gnome-app-create-menus-interp">gnome_app_create_menus_interp</a> (<a href="GnomeApp.html" title="GnomeApp">GnomeApp</a> *app,
<a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo">GnomeUIInfo</a> *uiinfo,
<a
href="/usr/share/gtk-doc/html/gtk/gtk-Types.html#GtkCallbackMarshal"
>GtkCallbackMarshal</a> relay_func,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> data,
<a
href="/usr/share/gtk-doc/html/gtk/gtk-Types.html#GtkDestroyNotify"
>GtkDestroyNotify</a> destroy_func);
void <a href="libgnomeui-gnome-app-helper.html#gnome-app-create-menus-with-data">gnome_app_create_menus_with_data</a>
(<a href="GnomeApp.html" title="GnomeApp">GnomeApp</a> *app,
<a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo">GnomeUIInfo</a> *uiinfo,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> user_data);
void <a href="libgnomeui-gnome-app-helper.html#gnome-app-create-menus-custom">gnome_app_create_menus_custom</a> (<a href="GnomeApp.html" title="GnomeApp">GnomeApp</a> *app,
<a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo">GnomeUIInfo</a> *uiinfo,
<a href="libgnomeui-gnome-app-helper.html#GnomeUIBuilderData">GnomeUIBuilderData</a> *uibdata);
void <a href="libgnomeui-gnome-app-helper.html#gnome-app-fill-toolbar">gnome_app_fill_toolbar</a> (<a
href="/usr/share/gtk-doc/html/gtk/GtkToolbar.html"
>GtkToolbar</a> *toolbar,
<a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo">GnomeUIInfo</a> *uiinfo,
<a
href="/usr/share/gtk-doc/html/gtk/gtk-Keyboard-Accelerators.html#GtkAccelGroup"
>GtkAccelGroup</a> *accel_group);
void <a href="libgnomeui-gnome-app-helper.html#gnome-app-fill-toolbar-with-data">gnome_app_fill_toolbar_with_data</a>
(<a
href="/usr/share/gtk-doc/html/gtk/GtkToolbar.html"
>GtkToolbar</a> *toolbar,
<a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo">GnomeUIInfo</a> *uiinfo,
<a
href="/usr/share/gtk-doc/html/gtk/gtk-Keyboard-Accelerators.html#GtkAccelGroup"
>GtkAccelGroup</a> *accel_group,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> user_data);
void <a href="libgnomeui-gnome-app-helper.html#gnome-app-fill-toolbar-custom">gnome_app_fill_toolbar_custom</a> (<a
href="/usr/share/gtk-doc/html/gtk/GtkToolbar.html"
>GtkToolbar</a> *toolbar,
<a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo">GnomeUIInfo</a> *uiinfo,
<a href="libgnomeui-gnome-app-helper.html#GnomeUIBuilderData">GnomeUIBuilderData</a> *uibdata,
<a
href="/usr/share/gtk-doc/html/gtk/gtk-Keyboard-Accelerators.html#GtkAccelGroup"
>GtkAccelGroup</a> *accel_group);
void <a href="libgnomeui-gnome-app-helper.html#gnome-app-create-toolbar">gnome_app_create_toolbar</a> (<a href="GnomeApp.html" title="GnomeApp">GnomeApp</a> *app,
<a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo">GnomeUIInfo</a> *uiinfo);
void <a href="libgnomeui-gnome-app-helper.html#gnome-app-create-toolbar-interp">gnome_app_create_toolbar_interp</a> (<a href="GnomeApp.html" title="GnomeApp">GnomeApp</a> *app,
<a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo">GnomeUIInfo</a> *uiinfo,
<a
href="/usr/share/gtk-doc/html/gtk/gtk-Types.html#GtkCallbackMarshal"
>GtkCallbackMarshal</a> relay_func,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> data,
<a
href="/usr/share/gtk-doc/html/gtk/gtk-Types.html#GtkDestroyNotify"
>GtkDestroyNotify</a> destroy_func);
void <a href="libgnomeui-gnome-app-helper.html#gnome-app-create-toolbar-with-data">gnome_app_create_toolbar_with_data</a>
(<a href="GnomeApp.html" title="GnomeApp">GnomeApp</a> *app,
<a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo">GnomeUIInfo</a> *uiinfo,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> user_data);
void <a href="libgnomeui-gnome-app-helper.html#gnome-app-create-toolbar-custom">gnome_app_create_toolbar_custom</a> (<a href="GnomeApp.html" title="GnomeApp">GnomeApp</a> *app,
<a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo">GnomeUIInfo</a> *uiinfo,
<a href="libgnomeui-gnome-app-helper.html#GnomeUIBuilderData">GnomeUIBuilderData</a> *uibdata);
<a
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
>GtkWidget</a>* <a href="libgnomeui-gnome-app-helper.html#gnome-app-find-menu-pos">gnome_app_find_menu_pos</a> (<a
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
>GtkWidget</a> *parent,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *path,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> *pos);
void <a href="libgnomeui-gnome-app-helper.html#gnome-app-remove-menus">gnome_app_remove_menus</a> (<a href="GnomeApp.html" title="GnomeApp">GnomeApp</a> *app,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *path,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> items);
void <a href="libgnomeui-gnome-app-helper.html#gnome-app-remove-menu-range">gnome_app_remove_menu_range</a> (<a href="GnomeApp.html" title="GnomeApp">GnomeApp</a> *app,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *path,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> start,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> items);
void <a href="libgnomeui-gnome-app-helper.html#gnome-app-insert-menus-custom">gnome_app_insert_menus_custom</a> (<a href="GnomeApp.html" title="GnomeApp">GnomeApp</a> *app,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *path,
<a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo">GnomeUIInfo</a> *uiinfo,
<a href="libgnomeui-gnome-app-helper.html#GnomeUIBuilderData">GnomeUIBuilderData</a> *uibdata);
void <a href="libgnomeui-gnome-app-helper.html#gnome-app-insert-menus">gnome_app_insert_menus</a> (<a href="GnomeApp.html" title="GnomeApp">GnomeApp</a> *app,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *path,
<a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo">GnomeUIInfo</a> *menuinfo);
void <a href="libgnomeui-gnome-app-helper.html#gnome-app-insert-menus-with-data">gnome_app_insert_menus_with_data</a>
(<a href="GnomeApp.html" title="GnomeApp">GnomeApp</a> *app,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *path,
<a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo">GnomeUIInfo</a> *menuinfo,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> data);
void <a href="libgnomeui-gnome-app-helper.html#gnome-app-insert-menus-interp">gnome_app_insert_menus_interp</a> (<a href="GnomeApp.html" title="GnomeApp">GnomeApp</a> *app,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *path,
<a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo">GnomeUIInfo</a> *menuinfo,
<a
href="/usr/share/gtk-doc/html/gtk/gtk-Types.html#GtkCallbackMarshal"
>GtkCallbackMarshal</a> relay_func,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> data,
<a
href="/usr/share/gtk-doc/html/gtk/gtk-Types.html#GtkDestroyNotify"
>GtkDestroyNotify</a> destroy_func);
void <a href="libgnomeui-gnome-app-helper.html#gnome-app-install-appbar-menu-hints">gnome_app_install_appbar_menu_hints</a>
(<a href="GnomeAppBar.html" title="GnomeAppBar">GnomeAppBar</a> *appbar,
<a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo">GnomeUIInfo</a> *uiinfo);
void <a href="libgnomeui-gnome-app-helper.html#gnome-app-install-statusbar-menu-hints">gnome_app_install_statusbar_menu_hints</a>
(<a
href="/usr/share/gtk-doc/html/gtk/GtkStatusbar.html"
>GtkStatusbar</a> *bar,
<a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo">GnomeUIInfo</a> *uiinfo);
void <a href="libgnomeui-gnome-app-helper.html#gnome-app-install-menu-hints">gnome_app_install_menu_hints</a> (<a href="GnomeApp.html" title="GnomeApp">GnomeApp</a> *app,
<a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo">GnomeUIInfo</a> *uiinfo);
void <a href="libgnomeui-gnome-app-helper.html#gnome-app-setup-toolbar">gnome_app_setup_toolbar</a> (<a
href="/usr/share/gtk-doc/html/gtk/GtkToolbar.html"
>GtkToolbar</a> *toolbar,
BonoboDockItem *dock_item);
#define <a href="libgnomeui-gnome-app-helper.html#GNOMEUIINFO-END:CAPS">GNOMEUIINFO_END</a>
#define <a href="libgnomeui-gnome-app-helper.html#GNOMEUIINFO-SEPARATOR:CAPS">GNOMEUIINFO_SEPARATOR</a>
#define <a href="libgnomeui-gnome-app-helper.html#GNOMEUIINFO-ITEM:CAPS">GNOMEUIINFO_ITEM</a> (label, tooltip, callback, xpm_data)
#define <a href="libgnomeui-gnome-app-helper.html#GNOMEUIINFO-ITEM-STOCK:CAPS">GNOMEUIINFO_ITEM_STOCK</a> (label, tooltip, callback, stock_id)
#define <a href="libgnomeui-gnome-app-helper.html#GNOMEUIINFO-ITEM-NONE:CAPS">GNOMEUIINFO_ITEM_NONE</a> (label, tooltip, callback)
#define <a href="libgnomeui-gnome-app-helper.html#GNOMEUIINFO-ITEM-DATA:CAPS">GNOMEUIINFO_ITEM_DATA</a> (label, tooltip, callback, user_data, xpm_data)
#define <a href="libgnomeui-gnome-app-helper.html#GNOMEUIINFO-TOGGLEITEM:CAPS">GNOMEUIINFO_TOGGLEITEM</a> (label, tooltip, callback, xpm_data)
#define <a href="libgnomeui-gnome-app-helper.html#GNOMEUIINFO-TOGGLEITEM-DATA:CAPS">GNOMEUIINFO_TOGGLEITEM_DATA</a> (label, tooltip, callback, user_data, xpm_data)
#define <a href="libgnomeui-gnome-app-helper.html#GNOMEUIINFO-HELP:CAPS">GNOMEUIINFO_HELP</a> (app_name)
#define <a href="libgnomeui-gnome-app-helper.html#GNOMEUIINFO-SUBTREE:CAPS">GNOMEUIINFO_SUBTREE</a> (label, tree)
#define <a href="libgnomeui-gnome-app-helper.html#GNOMEUIINFO-SUBTREE-HINT:CAPS">GNOMEUIINFO_SUBTREE_HINT</a> (label, hint, tree)
#define <a href="libgnomeui-gnome-app-helper.html#GNOMEUIINFO-SUBTREE-STOCK:CAPS">GNOMEUIINFO_SUBTREE_STOCK</a> (label, tree, stock_id)
#define <a href="libgnomeui-gnome-app-helper.html#GNOMEUIINFO-INCLUDE:CAPS">GNOMEUIINFO_INCLUDE</a> (tree)
#define <a href="libgnomeui-gnome-app-helper.html#GNOMEUIINFO-RADIOLIST:CAPS">GNOMEUIINFO_RADIOLIST</a> (list)
#define <a href="libgnomeui-gnome-app-helper.html#GNOMEUIINFO-RADIOITEM:CAPS">GNOMEUIINFO_RADIOITEM</a> (label, tooltip, callback, xpm_data)
#define <a href="libgnomeui-gnome-app-helper.html#GNOMEUIINFO-RADIOITEM-DATA:CAPS">GNOMEUIINFO_RADIOITEM_DATA</a> (label, tooltip, callback, user_data, xpm_data)
#define <a href="libgnomeui-gnome-app-helper.html#GNOMEUIINFO-MENU-NEW-ITEM:CAPS">GNOMEUIINFO_MENU_NEW_ITEM</a> (label, tip, cb, data)
#define <a href="libgnomeui-gnome-app-helper.html#GNOMEUIINFO-MENU-NEW-SUBTREE:CAPS">GNOMEUIINFO_MENU_NEW_SUBTREE</a> (tree)
#define <a href="libgnomeui-gnome-app-helper.html#GNOMEUIINFO-MENU-OPEN-ITEM:CAPS">GNOMEUIINFO_MENU_OPEN_ITEM</a> (cb, data)
#define <a href="libgnomeui-gnome-app-helper.html#GNOMEUIINFO-MENU-SAVE-ITEM:CAPS">GNOMEUIINFO_MENU_SAVE_ITEM</a> (cb, data)
#define <a href="libgnomeui-gnome-app-helper.html#GNOMEUIINFO-MENU-SAVE-AS-ITEM:CAPS">GNOMEUIINFO_MENU_SAVE_AS_ITEM</a> (cb, data)
#define <a href="libgnomeui-gnome-app-helper.html#GNOMEUIINFO-MENU-REVERT-ITEM:CAPS">GNOMEUIINFO_MENU_REVERT_ITEM</a> (cb, data)
#define <a href="libgnomeui-gnome-app-helper.html#GNOMEUIINFO-MENU-PRINT-ITEM:CAPS">GNOMEUIINFO_MENU_PRINT_ITEM</a> (cb, data)
#define <a href="libgnomeui-gnome-app-helper.html#GNOMEUIINFO-MENU-PRINT-SETUP-ITEM:CAPS">GNOMEUIINFO_MENU_PRINT_SETUP_ITEM</a>(cb, data)
#define <a href="libgnomeui-gnome-app-helper.html#GNOMEUIINFO-MENU-CLOSE-ITEM:CAPS">GNOMEUIINFO_MENU_CLOSE_ITEM</a> (cb, data)
#define <a href="libgnomeui-gnome-app-helper.html#GNOMEUIINFO-MENU-EXIT-ITEM:CAPS">GNOMEUIINFO_MENU_EXIT_ITEM</a> (cb, data)
#define <a href="libgnomeui-gnome-app-helper.html#GNOMEUIINFO-MENU-QUIT-ITEM:CAPS">GNOMEUIINFO_MENU_QUIT_ITEM</a> (cb, data)
#define <a href="libgnomeui-gnome-app-helper.html#GNOMEUIINFO-MENU-CUT-ITEM:CAPS">GNOMEUIINFO_MENU_CUT_ITEM</a> (cb, data)
#define <a href="libgnomeui-gnome-app-helper.html#GNOMEUIINFO-MENU-COPY-ITEM:CAPS">GNOMEUIINFO_MENU_COPY_ITEM</a> (cb, data)
#define <a href="libgnomeui-gnome-app-helper.html#GNOMEUIINFO-MENU-PASTE-ITEM:CAPS">GNOMEUIINFO_MENU_PASTE_ITEM</a> (cb, data)
#define <a href="libgnomeui-gnome-app-helper.html#GNOMEUIINFO-MENU-SELECT-ALL-ITEM:CAPS">GNOMEUIINFO_MENU_SELECT_ALL_ITEM</a>(cb, data)
#define <a href="libgnomeui-gnome-app-helper.html#GNOMEUIINFO-MENU-CLEAR-ITEM:CAPS">GNOMEUIINFO_MENU_CLEAR_ITEM</a> (cb, data)
#define <a href="libgnomeui-gnome-app-helper.html#GNOMEUIINFO-MENU-UNDO-ITEM:CAPS">GNOMEUIINFO_MENU_UNDO_ITEM</a> (cb, data)
#define <a href="libgnomeui-gnome-app-helper.html#GNOMEUIINFO-MENU-REDO-ITEM:CAPS">GNOMEUIINFO_MENU_REDO_ITEM</a> (cb, data)
#define <a href="libgnomeui-gnome-app-helper.html#GNOMEUIINFO-MENU-FIND-ITEM:CAPS">GNOMEUIINFO_MENU_FIND_ITEM</a> (cb, data)
#define <a href="libgnomeui-gnome-app-helper.html#GNOMEUIINFO-MENU-FIND-AGAIN-ITEM:CAPS">GNOMEUIINFO_MENU_FIND_AGAIN_ITEM</a>(cb, data)
#define <a href="libgnomeui-gnome-app-helper.html#GNOMEUIINFO-MENU-REPLACE-ITEM:CAPS">GNOMEUIINFO_MENU_REPLACE_ITEM</a> (cb, data)
#define <a href="libgnomeui-gnome-app-helper.html#GNOMEUIINFO-MENU-PROPERTIES-ITEM:CAPS">GNOMEUIINFO_MENU_PROPERTIES_ITEM</a>(cb, data)
#define <a href="libgnomeui-gnome-app-helper.html#GNOMEUIINFO-MENU-PREFERENCES-ITEM:CAPS">GNOMEUIINFO_MENU_PREFERENCES_ITEM</a>(cb, data)
#define <a href="libgnomeui-gnome-app-helper.html#GNOMEUIINFO-MENU-NEW-WINDOW-ITEM:CAPS">GNOMEUIINFO_MENU_NEW_WINDOW_ITEM</a>(cb, data)
#define <a href="libgnomeui-gnome-app-helper.html#GNOMEUIINFO-MENU-CLOSE-WINDOW-ITEM:CAPS">GNOMEUIINFO_MENU_CLOSE_WINDOW_ITEM</a>(cb, data)
#define <a href="libgnomeui-gnome-app-helper.html#GNOMEUIINFO-MENU-ABOUT-ITEM:CAPS">GNOMEUIINFO_MENU_ABOUT_ITEM</a> (cb, data)
#define <a href="libgnomeui-gnome-app-helper.html#GNOMEUIINFO-MENU-NEW-GAME-ITEM:CAPS">GNOMEUIINFO_MENU_NEW_GAME_ITEM</a> (cb, data)
#define <a href="libgnomeui-gnome-app-helper.html#GNOMEUIINFO-MENU-PAUSE-GAME-ITEM:CAPS">GNOMEUIINFO_MENU_PAUSE_GAME_ITEM</a>(cb, data)
#define <a href="libgnomeui-gnome-app-helper.html#GNOMEUIINFO-MENU-RESTART-GAME-ITEM:CAPS">GNOMEUIINFO_MENU_RESTART_GAME_ITEM</a>(cb, data)
#define <a href="libgnomeui-gnome-app-helper.html#GNOMEUIINFO-MENU-UNDO-MOVE-ITEM:CAPS">GNOMEUIINFO_MENU_UNDO_MOVE_ITEM</a> (cb, data)
#define <a href="libgnomeui-gnome-app-helper.html#GNOMEUIINFO-MENU-REDO-MOVE-ITEM:CAPS">GNOMEUIINFO_MENU_REDO_MOVE_ITEM</a> (cb, data)
#define <a href="libgnomeui-gnome-app-helper.html#GNOMEUIINFO-MENU-HINT-ITEM:CAPS">GNOMEUIINFO_MENU_HINT_ITEM</a> (cb, data)
#define <a href="libgnomeui-gnome-app-helper.html#GNOMEUIINFO-MENU-SCORES-ITEM:CAPS">GNOMEUIINFO_MENU_SCORES_ITEM</a> (cb, data)
#define <a href="libgnomeui-gnome-app-helper.html#GNOMEUIINFO-MENU-END-GAME-ITEM:CAPS">GNOMEUIINFO_MENU_END_GAME_ITEM</a> (cb, data)
#define <a href="libgnomeui-gnome-app-helper.html#GNOMEUIINFO-MENU-FILE-TREE:CAPS">GNOMEUIINFO_MENU_FILE_TREE</a> (tree)
#define <a href="libgnomeui-gnome-app-helper.html#GNOMEUIINFO-MENU-EDIT-TREE:CAPS">GNOMEUIINFO_MENU_EDIT_TREE</a> (tree)
#define <a href="libgnomeui-gnome-app-helper.html#GNOMEUIINFO-MENU-VIEW-TREE:CAPS">GNOMEUIINFO_MENU_VIEW_TREE</a> (tree)
#define <a href="libgnomeui-gnome-app-helper.html#GNOMEUIINFO-MENU-SETTINGS-TREE:CAPS">GNOMEUIINFO_MENU_SETTINGS_TREE</a> (tree)
#define <a href="libgnomeui-gnome-app-helper.html#GNOMEUIINFO-MENU-FILES-TREE:CAPS">GNOMEUIINFO_MENU_FILES_TREE</a> (tree)
#define <a href="libgnomeui-gnome-app-helper.html#GNOMEUIINFO-MENU-WINDOWS-TREE:CAPS">GNOMEUIINFO_MENU_WINDOWS_TREE</a> (tree)
#define <a href="libgnomeui-gnome-app-helper.html#GNOMEUIINFO-MENU-HELP-TREE:CAPS">GNOMEUIINFO_MENU_HELP_TREE</a> (tree)
#define <a href="libgnomeui-gnome-app-helper.html#GNOMEUIINFO-MENU-GAME-TREE:CAPS">GNOMEUIINFO_MENU_GAME_TREE</a> (tree)
#define <a href="libgnomeui-gnome-app-helper.html#GNOME-MENU-FILE-STRING:CAPS">GNOME_MENU_FILE_STRING</a>
#define <a href="libgnomeui-gnome-app-helper.html#GNOME-MENU-FILE-PATH:CAPS">GNOME_MENU_FILE_PATH</a>
#define <a href="libgnomeui-gnome-app-helper.html#GNOME-MENU-EDIT-STRING:CAPS">GNOME_MENU_EDIT_STRING</a>
#define <a href="libgnomeui-gnome-app-helper.html#GNOME-MENU-EDIT-PATH:CAPS">GNOME_MENU_EDIT_PATH</a>
#define <a href="libgnomeui-gnome-app-helper.html#GNOME-MENU-VIEW-STRING:CAPS">GNOME_MENU_VIEW_STRING</a>
#define <a href="libgnomeui-gnome-app-helper.html#GNOME-MENU-VIEW-PATH:CAPS">GNOME_MENU_VIEW_PATH</a>
#define <a href="libgnomeui-gnome-app-helper.html#GNOME-MENU-SETTINGS-STRING:CAPS">GNOME_MENU_SETTINGS_STRING</a>
#define <a href="libgnomeui-gnome-app-helper.html#GNOME-MENU-SETTINGS-PATH:CAPS">GNOME_MENU_SETTINGS_PATH</a>
#define <a href="libgnomeui-gnome-app-helper.html#GNOME-MENU-NEW-STRING:CAPS">GNOME_MENU_NEW_STRING</a>
#define <a href="libgnomeui-gnome-app-helper.html#GNOME-MENU-NEW-PATH:CAPS">GNOME_MENU_NEW_PATH</a>
#define <a href="libgnomeui-gnome-app-helper.html#GNOME-MENU-FILES-STRING:CAPS">GNOME_MENU_FILES_STRING</a>
#define <a href="libgnomeui-gnome-app-helper.html#GNOME-MENU-FILES-PATH:CAPS">GNOME_MENU_FILES_PATH</a>
#define <a href="libgnomeui-gnome-app-helper.html#GNOME-MENU-WINDOWS-STRING:CAPS">GNOME_MENU_WINDOWS_STRING</a>
#define <a href="libgnomeui-gnome-app-helper.html#GNOME-MENU-WINDOWS-PATH:CAPS">GNOME_MENU_WINDOWS_PATH</a>
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a>* <a href="libgnomeui-gnome-app-helper.html#gnome-app-helper-gettext">gnome_app_helper_gettext</a> (const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *string);
#define <a href="libgnomeui-gnome-app-helper.html#L-:CAPS">L_</a> (x)
#define <a href="libgnomeui-gnome-app-helper.html#D-:CAPS">D_</a> (x)
</pre>
</div>
<div class="refsect1" lang="en">
<a name="id2933277"></a><h2>Description</h2>
<p>
This module lets a developer easily create menus and toolbars for use in their
applications. Basically, a hierarchy of <a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo"><span class="type">GnomeUIInfo</span></a> structures are defined and
then the appropriate functions from this module are called to create the menu
or tool bars.
</p>
</div>
<div class="refsect1" lang="en">
<a name="id2933303"></a><h2>Details</h2>
<div class="refsect2" lang="en">
<a name="id2933313"></a><h3>
<a name="GnomeUIInfoType"></a>enum GnomeUIInfoType</h3>
<a class="indexterm" name="id2933326"></a><pre class="programlisting">typedef enum {
GNOME_APP_UI_ENDOFINFO,
GNOME_APP_UI_ITEM,
GNOME_APP_UI_TOGGLEITEM,
GNOME_APP_UI_RADIOITEMS,
GNOME_APP_UI_SUBTREE,
GNOME_APP_UI_SEPARATOR,
GNOME_APP_UI_HELP,
GNOME_APP_UI_BUILDER_DATA,
GNOME_APP_UI_ITEM_CONFIGURABLE,
GNOME_APP_UI_SUBTREE_STOCK,
GNOME_APP_UI_INCLUDE
} GnomeUIInfoType;
</pre>
<p>
These values identify the item type that a particular GnomeUIInfo structure
specifies.
</p>
<p>
One should be careful when using gnome_app_create_[custom|interp|with_data]
functions with <a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo"><span class="type">GnomeUIInfo</span></a> arrays containing <a href="libgnomeui-gnome-app-helper.html#GNOME-APP-UI-BUILDER-DATA:CAPS"><span class="type">GNOME_APP_UI_BUILDER_DATA</span></a>
items, since their <a href="libgnomeui-gnome-app-helper.html#GnomeUIBuilderData"><span class="type">GnomeUIBuilderData</span></a> structures completely override the
ones generated or supplied by the above functions.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><a name="GNOME-APP-UI-ENDOFINFO:CAPS"></a><code class="literal">GNOME_APP_UI_ENDOFINFO</code></span></td>
<td> No more items, use it at the end of an array.
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GNOME-APP-UI-ITEM:CAPS"></a><code class="literal">GNOME_APP_UI_ITEM</code></span></td>
<td> Normal item, or radio item if it is inside a radioitems
group.
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GNOME-APP-UI-TOGGLEITEM:CAPS"></a><code class="literal">GNOME_APP_UI_TOGGLEITEM</code></span></td>
<td> Toggle (check box) item.
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GNOME-APP-UI-RADIOITEMS:CAPS"></a><code class="literal">GNOME_APP_UI_RADIOITEMS</code></span></td>
<td> Radio item group.
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GNOME-APP-UI-SUBTREE:CAPS"></a><code class="literal">GNOME_APP_UI_SUBTREE</code></span></td>
<td> Item that defines a subtree/submenu.
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GNOME-APP-UI-SEPARATOR:CAPS"></a><code class="literal">GNOME_APP_UI_SEPARATOR</code></span></td>
<td> Separator line (menus) or blank space (toolbars).
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GNOME-APP-UI-HELP:CAPS"></a><code class="literal">GNOME_APP_UI_HELP</code></span></td>
<td> Create a list of help topics, used in the Help menu.
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GNOME-APP-UI-BUILDER-DATA:CAPS"></a><code class="literal">GNOME_APP_UI_BUILDER_DATA</code></span></td>
<td> Specifies the builder data for the following
entries, see code for further info.
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GNOME-APP-UI-ITEM-CONFIGURABLE:CAPS"></a><code class="literal">GNOME_APP_UI_ITEM_CONFIGURABLE</code></span></td>
<td> A configurable menu item.
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GNOME-APP-UI-SUBTREE-STOCK:CAPS"></a><code class="literal">GNOME_APP_UI_SUBTREE_STOCK</code></span></td>
<td> Item that defines a subtree/submenu, same as
<a href="libgnomeui-gnome-app-helper.html#GNOME-APP-UI-SUBTREE:CAPS"><span class="type">GNOME_APP_UI_SUBTREE</span></a>, but the texts should be looked up in the libgnome
catalog.
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GNOME-APP-UI-INCLUDE:CAPS"></a><code class="literal">GNOME_APP_UI_INCLUDE</code></span></td>
<td> Almost like <em class="parameter"><code>GNOME_APP_UI_SUBTREE</code></em>, but inserts items
into the current menu or whatever, instead of making a submenu.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2933661"></a><h3>
<a name="GnomeUIInfoConfigurableTypes"></a>enum GnomeUIInfoConfigurableTypes</h3>
<a class="indexterm" name="id2933674"></a><pre class="programlisting">typedef enum {
/* 0 */
GNOME_APP_CONFIGURABLE_ITEM_NEW,
GNOME_APP_CONFIGURABLE_ITEM_OPEN,
GNOME_APP_CONFIGURABLE_ITEM_SAVE,
GNOME_APP_CONFIGURABLE_ITEM_SAVE_AS,
GNOME_APP_CONFIGURABLE_ITEM_REVERT,
GNOME_APP_CONFIGURABLE_ITEM_PRINT,
GNOME_APP_CONFIGURABLE_ITEM_PRINT_SETUP,
GNOME_APP_CONFIGURABLE_ITEM_CLOSE,
GNOME_APP_CONFIGURABLE_ITEM_QUIT,
GNOME_APP_CONFIGURABLE_ITEM_CUT,
/* 10 */
GNOME_APP_CONFIGURABLE_ITEM_COPY,
GNOME_APP_CONFIGURABLE_ITEM_PASTE,
GNOME_APP_CONFIGURABLE_ITEM_CLEAR,
GNOME_APP_CONFIGURABLE_ITEM_UNDO,
GNOME_APP_CONFIGURABLE_ITEM_REDO,
GNOME_APP_CONFIGURABLE_ITEM_FIND,
GNOME_APP_CONFIGURABLE_ITEM_FIND_AGAIN,
GNOME_APP_CONFIGURABLE_ITEM_REPLACE,
GNOME_APP_CONFIGURABLE_ITEM_PROPERTIES,
GNOME_APP_CONFIGURABLE_ITEM_PREFERENCES,
/* 20 */
GNOME_APP_CONFIGURABLE_ITEM_ABOUT,
GNOME_APP_CONFIGURABLE_ITEM_SELECT_ALL,
GNOME_APP_CONFIGURABLE_ITEM_NEW_WINDOW,
GNOME_APP_CONFIGURABLE_ITEM_CLOSE_WINDOW,
GNOME_APP_CONFIGURABLE_ITEM_NEW_GAME,
GNOME_APP_CONFIGURABLE_ITEM_PAUSE_GAME,
GNOME_APP_CONFIGURABLE_ITEM_RESTART_GAME,
GNOME_APP_CONFIGURABLE_ITEM_UNDO_MOVE,
GNOME_APP_CONFIGURABLE_ITEM_REDO_MOVE,
GNOME_APP_CONFIGURABLE_ITEM_HINT,
/* 30 */
GNOME_APP_CONFIGURABLE_ITEM_SCORES,
GNOME_APP_CONFIGURABLE_ITEM_END_GAME
} GnomeUIInfoConfigurableTypes;
</pre>
<p>
A user can redefine the accelerator keys for each menu item (if the
application supports this). This enum gives an identifier for each menu
shortcut that can possible be redefined. If an application is not using one
of these accelerators, then no shortcut redefinition is possible unless the
application specifically implements it (moral: use standard menu items).</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><a name="GNOME-APP-CONFIGURABLE-ITEM-NEW:CAPS"></a><code class="literal">GNOME_APP_CONFIGURABLE_ITEM_NEW</code></span></td>
<td> The "New" menu.
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GNOME-APP-CONFIGURABLE-ITEM-OPEN:CAPS"></a><code class="literal">GNOME_APP_CONFIGURABLE_ITEM_OPEN</code></span></td>
<td> The "Open" menu.
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GNOME-APP-CONFIGURABLE-ITEM-SAVE:CAPS"></a><code class="literal">GNOME_APP_CONFIGURABLE_ITEM_SAVE</code></span></td>
<td> The "Save" menu.
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GNOME-APP-CONFIGURABLE-ITEM-SAVE-AS:CAPS"></a><code class="literal">GNOME_APP_CONFIGURABLE_ITEM_SAVE_AS</code></span></td>
<td> The "Save as..." menu.
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GNOME-APP-CONFIGURABLE-ITEM-REVERT:CAPS"></a><code class="literal">GNOME_APP_CONFIGURABLE_ITEM_REVERT</code></span></td>
<td> The "Revert" menu.
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GNOME-APP-CONFIGURABLE-ITEM-PRINT:CAPS"></a><code class="literal">GNOME_APP_CONFIGURABLE_ITEM_PRINT</code></span></td>
<td> The "Print" menu.
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GNOME-APP-CONFIGURABLE-ITEM-PRINT-SETUP:CAPS"></a><code class="literal">GNOME_APP_CONFIGURABLE_ITEM_PRINT_SETUP</code></span></td>
<td> The "Print setup..." menu.
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GNOME-APP-CONFIGURABLE-ITEM-CLOSE:CAPS"></a><code class="literal">GNOME_APP_CONFIGURABLE_ITEM_CLOSE</code></span></td>
<td> The "Close" menu.
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GNOME-APP-CONFIGURABLE-ITEM-QUIT:CAPS"></a><code class="literal">GNOME_APP_CONFIGURABLE_ITEM_QUIT</code></span></td>
<td> The "Quit" menu.
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GNOME-APP-CONFIGURABLE-ITEM-CUT:CAPS"></a><code class="literal">GNOME_APP_CONFIGURABLE_ITEM_CUT</code></span></td>
<td> The "Cut" menu.
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GNOME-APP-CONFIGURABLE-ITEM-COPY:CAPS"></a><code class="literal">GNOME_APP_CONFIGURABLE_ITEM_COPY</code></span></td>
<td> The "Copy" menu.
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GNOME-APP-CONFIGURABLE-ITEM-PASTE:CAPS"></a><code class="literal">GNOME_APP_CONFIGURABLE_ITEM_PASTE</code></span></td>
<td> The "Paste" menu.
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GNOME-APP-CONFIGURABLE-ITEM-CLEAR:CAPS"></a><code class="literal">GNOME_APP_CONFIGURABLE_ITEM_CLEAR</code></span></td>
<td> The "Clear" menu.
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GNOME-APP-CONFIGURABLE-ITEM-UNDO:CAPS"></a><code class="literal">GNOME_APP_CONFIGURABLE_ITEM_UNDO</code></span></td>
<td> The "Undo" menu.
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GNOME-APP-CONFIGURABLE-ITEM-REDO:CAPS"></a><code class="literal">GNOME_APP_CONFIGURABLE_ITEM_REDO</code></span></td>
<td> The "Redo" menu.
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GNOME-APP-CONFIGURABLE-ITEM-FIND:CAPS"></a><code class="literal">GNOME_APP_CONFIGURABLE_ITEM_FIND</code></span></td>
<td> The "Find..." menu.
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GNOME-APP-CONFIGURABLE-ITEM-FIND-AGAIN:CAPS"></a><code class="literal">GNOME_APP_CONFIGURABLE_ITEM_FIND_AGAIN</code></span></td>
<td> The "Find again" menu.
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GNOME-APP-CONFIGURABLE-ITEM-REPLACE:CAPS"></a><code class="literal">GNOME_APP_CONFIGURABLE_ITEM_REPLACE</code></span></td>
<td> The "Replace..." menu.
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GNOME-APP-CONFIGURABLE-ITEM-PROPERTIES:CAPS"></a><code class="literal">GNOME_APP_CONFIGURABLE_ITEM_PROPERTIES</code></span></td>
<td> The "Properties..." menu.
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GNOME-APP-CONFIGURABLE-ITEM-PREFERENCES:CAPS"></a><code class="literal">GNOME_APP_CONFIGURABLE_ITEM_PREFERENCES</code></span></td>
<td> The "Preferences..." menu.
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GNOME-APP-CONFIGURABLE-ITEM-ABOUT:CAPS"></a><code class="literal">GNOME_APP_CONFIGURABLE_ITEM_ABOUT</code></span></td>
<td> The "About..." menu.
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GNOME-APP-CONFIGURABLE-ITEM-SELECT-ALL:CAPS"></a><code class="literal">GNOME_APP_CONFIGURABLE_ITEM_SELECT_ALL</code></span></td>
<td> The "Select all" menu.
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GNOME-APP-CONFIGURABLE-ITEM-NEW-WINDOW:CAPS"></a><code class="literal">GNOME_APP_CONFIGURABLE_ITEM_NEW_WINDOW</code></span></td>
<td> The "New window" menu.
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GNOME-APP-CONFIGURABLE-ITEM-CLOSE-WINDOW:CAPS"></a><code class="literal">GNOME_APP_CONFIGURABLE_ITEM_CLOSE_WINDOW</code></span></td>
<td> The "Close window" menu.
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GNOME-APP-CONFIGURABLE-ITEM-NEW-GAME:CAPS"></a><code class="literal">GNOME_APP_CONFIGURABLE_ITEM_NEW_GAME</code></span></td>
<td> The "New game" menu.
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GNOME-APP-CONFIGURABLE-ITEM-PAUSE-GAME:CAPS"></a><code class="literal">GNOME_APP_CONFIGURABLE_ITEM_PAUSE_GAME</code></span></td>
<td> The "Pause game" menu.
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GNOME-APP-CONFIGURABLE-ITEM-RESTART-GAME:CAPS"></a><code class="literal">GNOME_APP_CONFIGURABLE_ITEM_RESTART_GAME</code></span></td>
<td> The "Restart game" menu.
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GNOME-APP-CONFIGURABLE-ITEM-UNDO-MOVE:CAPS"></a><code class="literal">GNOME_APP_CONFIGURABLE_ITEM_UNDO_MOVE</code></span></td>
<td> The "Undo move" menu.
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GNOME-APP-CONFIGURABLE-ITEM-REDO-MOVE:CAPS"></a><code class="literal">GNOME_APP_CONFIGURABLE_ITEM_REDO_MOVE</code></span></td>
<td> The "Redo move" menu.
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GNOME-APP-CONFIGURABLE-ITEM-HINT:CAPS"></a><code class="literal">GNOME_APP_CONFIGURABLE_ITEM_HINT</code></span></td>
<td> The "Hint" menu.
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GNOME-APP-CONFIGURABLE-ITEM-SCORES:CAPS"></a><code class="literal">GNOME_APP_CONFIGURABLE_ITEM_SCORES</code></span></td>
<td> The "Scores..." menu.
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GNOME-APP-CONFIGURABLE-ITEM-END-GAME:CAPS"></a><code class="literal">GNOME_APP_CONFIGURABLE_ITEM_END_GAME</code></span></td>
<td> The "End game" menu.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2934470"></a><h3>
<a name="GNOME-APP-CONFIGURABLE-ITEM-EXIT:CAPS"></a>GNOME_APP_CONFIGURABLE_ITEM_EXIT</h3>
<a class="indexterm" name="id2934484"></a><pre class="programlisting">#define GNOME_APP_CONFIGURABLE_ITEM_EXIT GNOME_APP_CONFIGURABLE_ITEM_QUIT
</pre>
<p>
The <code class="literal">EXIT</code> and <code class="literal">QUIT</code> commands are synonyms
(they were used interchangably and inconsistently in GNOME 1). This define
just makes this the case for configurable menu items as well. Note, however,
that in GNOME 2, the use of <span class="emphasis"><em>exit</em></span> is deprecated and all new
applications should use the word <span class="emphasis"><em>quit</em></span> whenever termination
of an application is being discussed.
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2934525"></a><h3>
<a name="GnomeUIPixmapType"></a>enum GnomeUIPixmapType</h3>
<a class="indexterm" name="id2934538"></a><pre class="programlisting">typedef enum {
GNOME_APP_PIXMAP_NONE,
GNOME_APP_PIXMAP_STOCK,
GNOME_APP_PIXMAP_DATA,
GNOME_APP_PIXMAP_FILENAME
} GnomeUIPixmapType;
</pre>
<p>
These values identify the type of pixmap used in an item.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><a name="GNOME-APP-PIXMAP-NONE:CAPS"></a><code class="literal">GNOME_APP_PIXMAP_NONE</code></span></td>
<td> No pixmap specified.
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GNOME-APP-PIXMAP-STOCK:CAPS"></a><code class="literal">GNOME_APP_PIXMAP_STOCK</code></span></td>
<td> Use a stock pixmap (<span class="type">GnomeStock</span>).
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GNOME-APP-PIXMAP-DATA:CAPS"></a><code class="literal">GNOME_APP_PIXMAP_DATA</code></span></td>
<td> Use a pixmap from inline xpm data.
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GNOME-APP-PIXMAP-FILENAME:CAPS"></a><code class="literal">GNOME_APP_PIXMAP_FILENAME</code></span></td>
<td> Use a pixmap from the specified filename.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2934663"></a><h3>
<a name="GnomeUIInfo"></a>GnomeUIInfo</h3>
<a class="indexterm" name="id2934675"></a><pre class="programlisting">typedef struct {
GnomeUIInfoType type; /* Type of item */
gchar const *label; /* String to use in item's label */
gchar const *hint; /* Tooltip for toolbar items, status
bar message for menu items. */
gpointer moreinfo; /* Extra information; depends on the
type. */
gpointer user_data; /* User data sent to the callback. */
gpointer unused_data; /* Should be NULL (reserved). */
GnomeUIPixmapType pixmap_type; /* Type of pixmap for this item. */
gconstpointer pixmap_info; /* Pointer to pixmap information. */
guint accelerator_key; /* Accelerator key, or 0 for none. */
GdkModifierType ac_mods; /* Mask of modifier keys for the
accelerator. */
GtkWidget *widget; /* Filled in by the gnome_app_create*
functions. */
} GnomeUIInfo;
</pre>
<p>
This is the structure that defines an item in a menu bar or toolbar. The
idea is to create an array of such structures with the information needed
to create menus or toolbars. The most convenient way to create such a
structure is to use the GNOMEUIINFO_* macros provided below.
</p>
<p>
The <em class="parameter"><code>moreinfo</code></em> parameter contents depend on the <em class="parameter"><code>type</code></em>. For 'item',
'toggleitem' and 'radioitem' types, this is a pointer to the function to
call when the item is activated. For 'subtrees', it is a pointer to another
array of <a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo"><span class="type">GnomeUIInfo</span></a> structures. For 'radioitem lead' entry, it is a
pointer to an array of <a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo"><span class="type">GnomeUIInfo</span></a> structures for the radio item group. For
a 'help' item, it specifies the help node to load (i.e. the application's
identifier) or <a
href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"
><code class="literal">NULL</code></a> for the main program's name. For 'builder data',
<em class="parameter"><code>moreinfo</code></em> points to the <a href="libgnomeui-gnome-app-helper.html#GnomeUIBuilderData"><span class="type">GnomeUIBuilderData</span></a> structure for the subsequent
items.
</p>
<p>
The contents of the <em class="parameter"><code>pixmap_info</code></em> depend upon the value of <em class="parameter"><code>pixmap_type</code></em>. If
<em class="parameter"><code>pixmap_type</code></em> is <em class="parameter"><code>GNOME_APP_PIXMAP_STOCK</code></em>, then <em class="parameter"><code>pixmap_info</code></em> is a pointer to a
stock icon name. For <a href="libgnomeui-gnome-app-helper.html#GNOME-APP-PIXMAP-DATA:CAPS"><span class="type">GNOME_APP_PIXMAP_DATA</span></a> pixmaps, <em class="parameter"><code>pixmap_info</code></em> is a
pointer to inline xpm data. For <a href="libgnomeui-gnome-app-helper.html#GNOME-APP-PIXMAP-FILENAME:CAPS"><span class="type">GNOME_APP_PIXMAP_FILENAME</span></a> pixmaps, it is a
pointer to the filename string.
</p>
<p>
When <em class="parameter"><code>type</code></em> is <a href="libgnomeui-gnome-app-helper.html#GNOME-APP-UI-ITEM-CONFIGURABLE:CAPS"><span class="type">GNOME_APP_UI_ITEM_CONFIGURABLE</span></a>, <em class="parameter"><code>accelerator_key</code></em> is
overloaded to be the name of the configurable pixmap (an element from the
<a href="libgnomeui-gnome-app-helper.html#GnomeUIInfoConfigurableTypes"><span class="type">GnomeUIInfoConfigurableTypes</span></a> enum). In this case <em class="parameter"><code>ac_mods</code></em> should be 0.
</p>
<p>
The <em class="parameter"><code>widget</code></em> field in the <a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo"><span class="type">GnomeUIInfo</span></a> structure is filled in by the creation
function. It can be used to tweak the widgets once they have been created if
the application requires that level of fine-grained control.
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2934896"></a><h3>
<a name="GnomeUIBuilderData"></a>GnomeUIBuilderData</h3>
<a class="indexterm" name="id2934909"></a><pre class="programlisting">typedef struct {
GnomeUISignalConnectFunc connect_func;
gpointer data;
gboolean is_interp;
GtkCallbackMarshal relay_func;
GtkDestroyNotify destroy_func;
} GnomeUIBuilderData;
</pre>
<p>
This structure defines how the relevant menu items are to have their signals
connected. This includes the activations signals, as well as the destroy
notifications. The affected menu items are either the items following aA
<a href="libgnomeui-gnome-app-helper.html#GNOME-APP-UI-BUILDER-DATA:CAPS"><span class="type">GNOME_APP_UI_BUILDER_DATA</span></a> item in an array of <a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo"><span class="type">GnomeUIInfo</span></a> structures or
all of the menu items that are connected as a result of a call to
<code class="function">gnome_app_create_menu_custom()</code> and similar functions.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><a href="libgnomeui-gnome-app-helper.html#GnomeUISignalConnectFunc">GnomeUISignalConnectFunc</a> <em class="structfield"><code>connect_func</code></em>;</span></td>
<td> Function that connects to the item's signals.
</td>
</tr>
<tr>
<td>
<span class="term"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> <em class="structfield"><code>data</code></em>;</span></td>
<td> User data pointer for the signal callback.
</td>
</tr>
<tr>
<td>
<span class="term"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> <em class="structfield"><code>is_interp</code></em>;</span></td>
<td> If <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
><code class="literal">TRUE</code></a>, the signal should be connected with
<a
href="/usr/share/gtk-doc/html/gobject/gobject-Signals.html#g-signal-connect-closure-by-id"
><code class="function">g_signal_connect_closure_by_id()</code></a>, otherwise, <a
href="/usr/share/gtk-doc/html/gobject/gobject-Signals.html#g-signal-connect"
><code class="function">g_signal_connect()</code></a> is used.
</td>
</tr>
<tr>
<td>
<span class="term"><a
href="/usr/share/gtk-doc/html/gtk/gtk-Types.html#GtkCallbackMarshal"
>GtkCallbackMarshal</a> <em class="structfield"><code>relay_func</code></em>;</span></td>
<td> Marshaller function for language bindings.
</td>
</tr>
<tr>
<td>
<span class="term"><a
href="/usr/share/gtk-doc/html/gtk/gtk-Types.html#GtkDestroyNotify"
>GtkDestroyNotify</a> <em class="structfield"><code>destroy_func</code></em>;</span></td>
<td> Destroy notification function for language bindings.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2935111"></a><h3>
<a name="GNOMEUIINFO-KEY-UIDATA:CAPS"></a>GNOMEUIINFO_KEY_UIDATA</h3>
<a class="indexterm" name="id2935124"></a><pre class="programlisting">#define GNOMEUIINFO_KEY_UIDATA "uidata"
</pre>
<p>
The <code class="literal">widget</code> element in a <a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo"><span class="type">GnomeUIInfo</span></a> structure will have
this parameter set to the user data that was given in the <a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo"><span class="type">GnomeUIInfo</span></a> instance.
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2935164"></a><h3>
<a name="GNOMEUIINFO-KEY-UIBDATA:CAPS"></a>GNOMEUIINFO_KEY_UIBDATA</h3>
<a class="indexterm" name="id2935177"></a><pre class="programlisting">#define GNOMEUIINFO_KEY_UIBDATA "uibdata"
</pre>
<p>
The <code class="literal">widget</code> element in a <a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo"><span class="type">GnomeUIInfo</span></a> structure will have
this parameter set to the user data that was given in the relevant
<a href="libgnomeui-gnome-app-helper.html#GnomeUIBuilderData"><span class="type">GnomeUIBuilderData</span></a> structure that was applicable at the time of construction
of the widget.
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2935218"></a><h3>
<a name="GnomeUISignalConnectFunc"></a>GnomeUISignalConnectFunc ()</h3>
<a class="indexterm" name="id2935231"></a><pre class="programlisting">void (*GnomeUISignalConnectFunc) (<a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo">GnomeUIInfo</a> *uiinfo,
const char *signal_name,
<a href="libgnomeui-gnome-app-helper.html#GnomeUIBuilderData">GnomeUIBuilderData</a> *uibdata);</pre>
<p>
The template for functions that are called as a result of signals being emitted
from a menu or tool bar item. Fnuctions of this type are given as the first
element of a <a href="libgnomeui-gnome-app-helper.html#GnomeUIBuilderData"><span class="type">GnomeUIBuilderData</span></a> instance.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>uiinfo</code></em> :</span></td>
<td>The user data that was part of the <a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo"><span class="type">GnomeUIInfo</span></a> instance.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>signal_name</code></em> :</span></td>
<td>The name of the emitted signal.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>uibdata</code></em> :</span></td>
<td>The user data that was part of the relevant <a href="libgnomeui-gnome-app-helper.html#GnomeUIBuilderData"><span class="type">GnomeUIBuilderData</span></a>
instance.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2935350"></a><h3>
<a name="gnome-accelerators-sync"></a>gnome_accelerators_sync ()</h3>
<a class="indexterm" name="id2935362"></a><pre class="programlisting">void gnome_accelerators_sync (void);</pre>
<p>
Flush the accelerator definitions into the application specific
configuration file $HOME/.gnome2/accels/<app-id>.</p>
<p>
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2935391"></a><h3>
<a name="gnome-app-fill-menu"></a>gnome_app_fill_menu ()</h3>
<a class="indexterm" name="id2935404"></a><pre class="programlisting">void gnome_app_fill_menu (<a
href="/usr/share/gtk-doc/html/gtk/GtkMenuShell.html"
>GtkMenuShell</a> *menu_shell,
<a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo">GnomeUIInfo</a> *uiinfo,
<a
href="/usr/share/gtk-doc/html/gtk/gtk-Keyboard-Accelerators.html#GtkAccelGroup"
>GtkAccelGroup</a> *accel_group,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> uline_accels,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> pos);</pre>
<p>
Fills the specified <em class="parameter"><code>menu_shell</code></em> with items created from the specified
<em class="parameter"><code>uiinfo</code></em>, inserting them from the item number <em class="parameter"><code>pos</code></em> on. The <em class="parameter"><code>accel_</code></em> group
will be used as the accel group for all newly created sub menus and serves
as the global accel group for all menu item hotkeys. If it is passed as
<a
href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"
><code class="literal">NULL</code></a>, global hotkeys will be disabled.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>menu_shell</code></em> :</span></td>
<td> A <a
href="/usr/share/gtk-doc/html/gtk/GtkMenuShell.html"
><span class="type">GtkMenuShell</span></a> instance (a menu bar).
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>uiinfo</code></em> :</span></td>
<td> A pointer to the first element in an array of <a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo"><span class="type">GnomeUIInfo</span></a>
structures. The last element of the array should have a type of
<a href="libgnomeui-gnome-app-helper.html#GNOME-APP-UI-ENDOFINFO:CAPS"><span class="type">GNOME_APP_UI_ENDOFINFO</span></a>.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>accel_group</code></em> :</span></td>
<td> A <a
href="/usr/share/gtk-doc/html/gtk/gtk-Keyboard-Accelerators.html#GtkAccelGroup"
><span class="type">GtkAccelGroup</span></a>.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>uline_accels</code></em> :</span></td>
<td> <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
><code class="literal">TRUE</code></a> if underline accelerators will be drawn for the menu
item labels.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>pos</code></em> :</span></td>
<td> The position in the menu bar at which to start inserting items.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2935626"></a><h3>
<a name="gnome-app-fill-menu-with-data"></a>gnome_app_fill_menu_with_data ()</h3>
<a class="indexterm" name="id2935640"></a><pre class="programlisting">void gnome_app_fill_menu_with_data (<a
href="/usr/share/gtk-doc/html/gtk/GtkMenuShell.html"
>GtkMenuShell</a> *menu_shell,
<a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo">GnomeUIInfo</a> *uiinfo,
<a
href="/usr/share/gtk-doc/html/gtk/gtk-Keyboard-Accelerators.html#GtkAccelGroup"
>GtkAccelGroup</a> *accel_group,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> uline_accels,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> pos,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> user_data);</pre>
<p>
This is the same as <a href="libgnomeui-gnome-app-helper.html#gnome-app-fill-menu"><code class="function">gnome_app_fill_menu()</code></a>, except that all the user data
pointers are filled with the value of <em class="parameter"><code>user_data</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>menu_shell</code></em> :</span></td>
<td> A <a
href="/usr/share/gtk-doc/html/gtk/GtkMenuShell.html"
><span class="type">GtkMenuShell</span></a> instance (a menu bar).
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>uiinfo</code></em> :</span></td>
<td> A pointer to the first element in an array of <a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo"><span class="type">GnomeUIInfo</span></a>
structures. The last element of the array should have a type of
<a href="libgnomeui-gnome-app-helper.html#GNOME-APP-UI-ENDOFINFO:CAPS"><span class="type">GNOME_APP_UI_ENDOFINFO</span></a>.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>accel_group</code></em> :</span></td>
<td> A <a
href="/usr/share/gtk-doc/html/gtk/gtk-Keyboard-Accelerators.html#GtkAccelGroup"
><span class="type">GtkAccelGroup</span></a>.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>uline_accels</code></em> :</span></td>
<td> <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
><code class="literal">TRUE</code></a> if underline accelerators will be drawn for the menu
item labels.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>pos</code></em> :</span></td>
<td> The position in the menu bar at which to start inserting items.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>user_data</code></em> :</span></td>
<td> Some application-specific data.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2935862"></a><h3>
<a name="gnome-app-fill-menu-custom"></a>gnome_app_fill_menu_custom ()</h3>
<a class="indexterm" name="id2935876"></a><pre class="programlisting">void gnome_app_fill_menu_custom (<a
href="/usr/share/gtk-doc/html/gtk/GtkMenuShell.html"
>GtkMenuShell</a> *menu_shell,
<a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo">GnomeUIInfo</a> *uiinfo,
<a href="libgnomeui-gnome-app-helper.html#GnomeUIBuilderData">GnomeUIBuilderData</a> *uibdata,
<a
href="/usr/share/gtk-doc/html/gtk/gtk-Keyboard-Accelerators.html#GtkAccelGroup"
>GtkAccelGroup</a> *accel_group,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> uline_accels,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> pos);</pre>
<p>
Fills the specified menu shell with items created from the specified
<em class="parameter"><code>uiinfo</code></em>, inserting them from item number <em class="parameter"><code>pos</code></em> on and using the specified
builder data (<em class="parameter"><code>uibdata</code></em>) -- this is intended for language bindings.
</p>
<p>
The other parameters have the same meaning as in <a href="libgnomeui-gnome-app-helper.html#gnome-app-fill-menu"><code class="function">gnome_app_fill_menu()</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>menu_shell</code></em> :</span></td>
<td> A <a
href="/usr/share/gtk-doc/html/gtk/GtkMenuShell.html"
><span class="type">GtkMenuShell</span></a> instance (a menu bar).
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>uiinfo</code></em> :</span></td>
<td> A pointer to the first element in an array of <a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo"><span class="type">GnomeUIInfo</span></a>
structures. The last element of the array should have a type of
<a href="libgnomeui-gnome-app-helper.html#GNOME-APP-UI-ENDOFINFO:CAPS"><span class="type">GNOME_APP_UI_ENDOFINFO</span></a>.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>uibdata</code></em> :</span></td>
<td> A <span class="type">GnomeUIInfoBuilderData</span> instance.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>accel_group</code></em> :</span></td>
<td> A <a
href="/usr/share/gtk-doc/html/gtk/gtk-Keyboard-Accelerators.html#GtkAccelGroup"
><span class="type">GtkAccelGroup</span></a>.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>uline_accels</code></em> :</span></td>
<td> <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
><code class="literal">TRUE</code></a> if underline accelerators will be drawn for the menu
item labels.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>pos</code></em> :</span></td>
<td> The position in the menu bar at which to start inserting items.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2936125"></a><h3>
<a name="gnome-app-ui-configure-configurable"></a>gnome_app_ui_configure_configurable ()</h3>
<a class="indexterm" name="id2936139"></a><pre class="programlisting">void gnome_app_ui_configure_configurable
(<a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo">GnomeUIInfo</a> *uiinfo);</pre>
<p>
Configure all user-configurable elements in the given UI info
structure. This includes loading and setting previously-set options from
GNOME config files.
</p>
<p>
Normally, <a href="libgnomeui-gnome-app-helper.html#gnome-app-create-menus"><code class="function">gnome_app_create_menus()</code></a> calls this function for the developer,
but if something needs to be altered afterwards, this function can be called
first. The main reason for this function being a public interface is so that
it can be called from <a href="libgnomeui-gnome-popup-menu.html#gnome-popup-menu-new"><code class="function">gnome_popup_menu_new()</code></a>, which clears a copy of the
pass in <a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo"><span class="type">GnomeUIInfo</span></a> structures.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td>
<span class="term"><em class="parameter"><code>uiinfo</code></em> :</span></td>
<td> Pointer to GNOME UI menu/toolbar info
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2936231"></a><h3>
<a name="gnome-app-create-menus"></a>gnome_app_create_menus ()</h3>
<a class="indexterm" name="id2936244"></a><pre class="programlisting">void gnome_app_create_menus (<a href="GnomeApp.html" title="GnomeApp">GnomeApp</a> *app,
<a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo">GnomeUIInfo</a> *uiinfo);</pre>
<p>
Constructs a menu bar and attaches it to the specified application
window.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>app</code></em> :</span></td>
<td> A <a href="GnomeApp.html" title="GnomeApp"><span class="type">GnomeApp</span></a> instance representing the current application.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>uiinfo</code></em> :</span></td>
<td> The first in an array <a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo"><span class="type">GnomeUIInfo</span></a> instances containing the menu
data.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2936333"></a><h3>
<a name="gnome-app-create-menus-interp"></a>gnome_app_create_menus_interp ()</h3>
<a class="indexterm" name="id2936347"></a><pre class="programlisting">void gnome_app_create_menus_interp (<a href="GnomeApp.html" title="GnomeApp">GnomeApp</a> *app,
<a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo">GnomeUIInfo</a> *uiinfo,
<a
href="/usr/share/gtk-doc/html/gtk/gtk-Types.html#GtkCallbackMarshal"
>GtkCallbackMarshal</a> relay_func,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> data,
<a
href="/usr/share/gtk-doc/html/gtk/gtk-Types.html#GtkDestroyNotify"
>GtkDestroyNotify</a> destroy_func);</pre>
<p>
Identical to <a href="libgnomeui-gnome-app-helper.html#gnome-app-create-menus"><code class="function">gnome_app_create_menus()</code></a>, except that extra functions and data
can be passed in for finer control of the destruction and marshalling.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>app</code></em> :</span></td>
<td> A <a href="GnomeApp.html" title="GnomeApp"><span class="type">GnomeApp</span></a> instance, representing the current application.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>uiinfo</code></em> :</span></td>
<td> The first item in an array of <a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo"><span class="type">GnomeUIInfo</span></a> structures describing
the menu bar.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>relay_func</code></em> :</span></td>
<td> A marshaller for the signal callbacks.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>data</code></em> :</span></td>
<td> Application specific data passed to the signal callback functions.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>destroy_func</code></em> :</span></td>
<td> The function to call when the menu bar is destroyed.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2936516"></a><h3>
<a name="gnome-app-create-menus-with-data"></a>gnome_app_create_menus_with_data ()</h3>
<a class="indexterm" name="id2936530"></a><pre class="programlisting">void gnome_app_create_menus_with_data
(<a href="GnomeApp.html" title="GnomeApp">GnomeApp</a> *app,
<a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo">GnomeUIInfo</a> *uiinfo,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> user_data);</pre>
<p>
Identical to <a href="libgnomeui-gnome-app-helper.html#gnome-app-create-menus"><code class="function">gnome_app_create_menus()</code></a>, except that <em class="parameter"><code>user_data</code></em> is passed to
all the callback functions when signals are emitted.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>app</code></em> :</span></td>
<td> A <a href="GnomeApp.html" title="GnomeApp"><span class="type">GnomeApp</span></a> instance representing the current application.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>uiinfo</code></em> :</span></td>
<td> The first in an array <a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo"><span class="type">GnomeUIInfo</span></a> instances containing the menu
data.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>user_data</code></em> :</span></td>
<td> Application-specific data that is passed to every callback
function.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2936660"></a><h3>
<a name="gnome-app-create-menus-custom"></a>gnome_app_create_menus_custom ()</h3>
<a class="indexterm" name="id2936674"></a><pre class="programlisting">void gnome_app_create_menus_custom (<a href="GnomeApp.html" title="GnomeApp">GnomeApp</a> *app,
<a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo">GnomeUIInfo</a> *uiinfo,
<a href="libgnomeui-gnome-app-helper.html#GnomeUIBuilderData">GnomeUIBuilderData</a> *uibdata);</pre>
<p>
Identical to <a href="libgnomeui-gnome-app-helper.html#gnome-app-create-menus"><code class="function">gnome_app_create_menus()</code></a>, except that <em class="parameter"><code>uibdata</code></em> is also
specified for creating the signal handlers. Mostly for use by language
bindings.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>app</code></em> :</span></td>
<td> A <a href="GnomeApp.html" title="GnomeApp"><span class="type">GnomeApp</span></a> instance representing the current application.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>uiinfo</code></em> :</span></td>
<td> The first in an array <a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo"><span class="type">GnomeUIInfo</span></a> instances containing the menu
data.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>uibdata</code></em> :</span></td>
<td> An appropriate <a href="libgnomeui-gnome-app-helper.html#GnomeUIBuilderData"><span class="type">GnomeUIBuilderData</span></a> instance.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2936811"></a><h3>
<a name="gnome-app-fill-toolbar"></a>gnome_app_fill_toolbar ()</h3>
<a class="indexterm" name="id2936824"></a><pre class="programlisting">void gnome_app_fill_toolbar (<a
href="/usr/share/gtk-doc/html/gtk/GtkToolbar.html"
>GtkToolbar</a> *toolbar,
<a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo">GnomeUIInfo</a> *uiinfo,
<a
href="/usr/share/gtk-doc/html/gtk/gtk-Keyboard-Accelerators.html#GtkAccelGroup"
>GtkAccelGroup</a> *accel_group);</pre>
<p>
Fills <em class="parameter"><code>toolbar</code></em> with buttons specified in <em class="parameter"><code>uiinfo</code></em>. If <em class="parameter"><code>accel_group</code></em> is not
<a
href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"
><code class="literal">NULL</code></a>, the items' accelrator keys are put into it.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>toolbar</code></em> :</span></td>
<td> A <a
href="/usr/share/gtk-doc/html/gtk/GtkToolbar.html"
><span class="type">GtkToolbar</span></a> instance.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>uiinfo</code></em> :</span></td>
<td> An array of <a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo"><span class="type">GnomeUIInfo</span></a> structures containing the items for the
toolbar.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>accel_group</code></em> :</span></td>
<td> A <a
href="/usr/share/gtk-doc/html/gtk/gtk-Keyboard-Accelerators.html#GtkAccelGroup"
><span class="type">GtkAccelGroup</span></a> for holding the accelerator keys of the items
(or <a
href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"
><code class="literal">NULL</code></a>).
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2936982"></a><h3>
<a name="gnome-app-fill-toolbar-with-data"></a>gnome_app_fill_toolbar_with_data ()</h3>
<a class="indexterm" name="id2936996"></a><pre class="programlisting">void gnome_app_fill_toolbar_with_data
(<a
href="/usr/share/gtk-doc/html/gtk/GtkToolbar.html"
>GtkToolbar</a> *toolbar,
<a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo">GnomeUIInfo</a> *uiinfo,
<a
href="/usr/share/gtk-doc/html/gtk/gtk-Keyboard-Accelerators.html#GtkAccelGroup"
>GtkAccelGroup</a> *accel_group,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> user_data);</pre>
<p>
The same as <a href="libgnomeui-gnome-app-helper.html#gnome-app-fill-toolbar"><code class="function">gnome_app_fill_toolbar()</code></a>, except that the user data pointers in
the signal handlers are set to <em class="parameter"><code>user_data</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>toolbar</code></em> :</span></td>
<td> A <a
href="/usr/share/gtk-doc/html/gtk/GtkToolbar.html"
><span class="type">GtkToolbar</span></a> instance.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>uiinfo</code></em> :</span></td>
<td> An array of <a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo"><span class="type">GnomeUIInfo</span></a> structures containing the items for the
toolbar.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>accel_group</code></em> :</span></td>
<td> A <a
href="/usr/share/gtk-doc/html/gtk/gtk-Keyboard-Accelerators.html#GtkAccelGroup"
><span class="type">GtkAccelGroup</span></a> for holding the accelerator keys of the items
(or <a
href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"
><code class="literal">NULL</code></a>).
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>user_data</code></em> :</span></td>
<td> Application specific data.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2937165"></a><h3>
<a name="gnome-app-fill-toolbar-custom"></a>gnome_app_fill_toolbar_custom ()</h3>
<a class="indexterm" name="id2937179"></a><pre class="programlisting">void gnome_app_fill_toolbar_custom (<a
href="/usr/share/gtk-doc/html/gtk/GtkToolbar.html"
>GtkToolbar</a> *toolbar,
<a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo">GnomeUIInfo</a> *uiinfo,
<a href="libgnomeui-gnome-app-helper.html#GnomeUIBuilderData">GnomeUIBuilderData</a> *uibdata,
<a
href="/usr/share/gtk-doc/html/gtk/gtk-Keyboard-Accelerators.html#GtkAccelGroup"
>GtkAccelGroup</a> *accel_group);</pre>
<p>
The same as <a href="libgnomeui-gnome-app-helper.html#gnome-app-fill-toolbar"><code class="function">gnome_app_fill_toolbar()</code></a>, except that the sepcified <em class="parameter"><code>uibdata</code></em>
instance is used. This is mostly for the benefit of language bindings.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>toolbar</code></em> :</span></td>
<td> A <a
href="/usr/share/gtk-doc/html/gtk/GtkToolbar.html"
><span class="type">GtkToolbar</span></a> instance.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>uiinfo</code></em> :</span></td>
<td> An array of <a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo"><span class="type">GnomeUIInfo</span></a> structures containing the items for the
toolbar.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>uibdata</code></em> :</span></td>
<td> The <a href="libgnomeui-gnome-app-helper.html#GnomeUIBuilderData"><span class="type">GnomeUIBuilderData</span></a> data for the toolbar.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>accel_group</code></em> :</span></td>
<td> A <a
href="/usr/share/gtk-doc/html/gtk/gtk-Keyboard-Accelerators.html#GtkAccelGroup"
><span class="type">GtkAccelGroup</span></a> for holding the accelerator keys of the items
(or <a
href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"
><code class="literal">NULL</code></a>).
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2937356"></a><h3>
<a name="gnome-app-create-toolbar"></a>gnome_app_create_toolbar ()</h3>
<a class="indexterm" name="id2937370"></a><pre class="programlisting">void gnome_app_create_toolbar (<a href="GnomeApp.html" title="GnomeApp">GnomeApp</a> *app,
<a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo">GnomeUIInfo</a> *uiinfo);</pre>
<p>
Constructs a toolbar and attaches it to the specified application
window.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>app</code></em> :</span></td>
<td> A <a href="GnomeApp.html" title="GnomeApp"><span class="type">GnomeApp</span></a> instance.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>uiinfo</code></em> :</span></td>
<td> A <a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo"><span class="type">GnomeUIInfo</span></a> array specifying the contents of the toolbar.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2937458"></a><h3>
<a name="gnome-app-create-toolbar-interp"></a>gnome_app_create_toolbar_interp ()</h3>
<a class="indexterm" name="id2937472"></a><pre class="programlisting">void gnome_app_create_toolbar_interp (<a href="GnomeApp.html" title="GnomeApp">GnomeApp</a> *app,
<a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo">GnomeUIInfo</a> *uiinfo,
<a
href="/usr/share/gtk-doc/html/gtk/gtk-Types.html#GtkCallbackMarshal"
>GtkCallbackMarshal</a> relay_func,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> data,
<a
href="/usr/share/gtk-doc/html/gtk/gtk-Types.html#GtkDestroyNotify"
>GtkDestroyNotify</a> destroy_func);</pre>
<p>
Constructs a toolbar and attaches it to the specified application
window -- this version is intended for language bindings.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>app</code></em> :</span></td>
<td> A <a href="GnomeApp.html" title="GnomeApp"><span class="type">GnomeApp</span></a> instance.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>uiinfo</code></em> :</span></td>
<td> A <a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo"><span class="type">GnomeUIInfo</span></a> array specifying the contents of the toolbar.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>relay_func</code></em> :</span></td>
<td> Argument marshalling function.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>data</code></em> :</span></td>
<td> Application specific data to pass to signal callbacks.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>destroy_func</code></em> :</span></td>
<td> The function to call when the toolbar is destroyed.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2937628"></a><h3>
<a name="gnome-app-create-toolbar-with-data"></a>gnome_app_create_toolbar_with_data ()</h3>
<a class="indexterm" name="id2937643"></a><pre class="programlisting">void gnome_app_create_toolbar_with_data
(<a href="GnomeApp.html" title="GnomeApp">GnomeApp</a> *app,
<a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo">GnomeUIInfo</a> *uiinfo,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> user_data);</pre>
<p>
Constructs a toolbar, sets all the user data pointers to
<em class="parameter"><code>user_data</code></em>, and attaches it to <em class="parameter"><code>app</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>app</code></em> :</span></td>
<td> A <a href="GnomeApp.html" title="GnomeApp"><span class="type">GnomeApp</span></a> instance.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>uiinfo</code></em> :</span></td>
<td> A <a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo"><span class="type">GnomeUIInfo</span></a> array specifying the contents of the toolbar.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>user_data</code></em> :</span></td>
<td> Application specific data to be sent to each signal callback
function.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2937765"></a><h3>
<a name="gnome-app-create-toolbar-custom"></a>gnome_app_create_toolbar_custom ()</h3>
<a class="indexterm" name="id2937779"></a><pre class="programlisting">void gnome_app_create_toolbar_custom (<a href="GnomeApp.html" title="GnomeApp">GnomeApp</a> *app,
<a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo">GnomeUIInfo</a> *uiinfo,
<a href="libgnomeui-gnome-app-helper.html#GnomeUIBuilderData">GnomeUIBuilderData</a> *uibdata);</pre>
<p>
Constructs a toolbar and attaches it to the <em class="parameter"><code>app</code></em> window,
using <em class="parameter"><code>uibdata</code></em> builder data -- intended for language bindings.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>app</code></em> :</span></td>
<td> A <a href="GnomeApp.html" title="GnomeApp"><span class="type">GnomeApp</span></a> instance.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>uiinfo</code></em> :</span></td>
<td> A <a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo"><span class="type">GnomeUIInfo</span></a> array specifying the contents of the toolbar.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>uibdata</code></em> :</span></td>
<td> A <a href="libgnomeui-gnome-app-helper.html#GnomeUIBuilderData"><span class="type">GnomeUIBuilderData</span></a> instance specifying the handlers to use for
the toolbar.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2937910"></a><h3>
<a name="gnome-app-find-menu-pos"></a>gnome_app_find_menu_pos ()</h3>
<a class="indexterm" name="id2937924"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
>GtkWidget</a>* gnome_app_find_menu_pos (<a
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
>GtkWidget</a> *parent,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *path,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> *pos);</pre>
<p>
Finds a menu item described by path starting in the <a
href="/usr/share/gtk-doc/html/gtk/GtkMenuShell.html"
><span class="type">GtkMenuShell</span></a> top and
returns its parent <a
href="/usr/share/gtk-doc/html/gtk/GtkMenuShell.html"
><span class="type">GtkMenuShell</span></a> and the position after this item in <em class="parameter"><code>pos</code></em>.
The meaning of <em class="parameter"><code>pos</code></em> is that a subsequent call to gtk_menu_shell_insert(p, w,
pos) would then insert widget w in GtkMenuShell p right after the menu item
described by 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>parent</code></em> :</span></td>
<td> Root menu shell widget containing menu items to be searched.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>path</code></em> :</span></td>
<td> Specifies the target menu item by menu path.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>pos</code></em> :</span></td>
<td> Used to hold the returned menu items' position.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> The parent menu shell of <em class="parameter"><code>path</code></em>.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2938067"></a><h3>
<a name="gnome-app-remove-menus"></a>gnome_app_remove_menus ()</h3>
<a class="indexterm" name="id2938081"></a><pre class="programlisting">void gnome_app_remove_menus (<a href="GnomeApp.html" title="GnomeApp">GnomeApp</a> *app,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *path,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> items);</pre>
<p>
Removes <em class="parameter"><code>items</code></em> items from the existing <em class="parameter"><code>app</code></em>'s menu structure,
beginning with item described by <em class="parameter"><code>path</code></em>.
</p>
<p>
The <em class="parameter"><code>path</code></em> argument should be in the form "File/.../.../Something". "" will
insert the item as the first one in the menubar, "File/" will insert it as
the first one in the File menu, "File/Settings" will insert it after the
Setting item in the File menu use of "File/<Separator>" should be obvious.
However, the use of "<Seperator>" stops after the first separator.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>app</code></em> :</span></td>
<td> A <a href="GnomeApp.html" title="GnomeApp"><span class="type">GnomeApp</span></a> instance.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>path</code></em> :</span></td>
<td> A path to the menu item concerned.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>items</code></em> :</span></td>
<td> The number of items to remove.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2938218"></a><h3>
<a name="gnome-app-remove-menu-range"></a>gnome_app_remove_menu_range ()</h3>
<a class="indexterm" name="id2938232"></a><pre class="programlisting">void gnome_app_remove_menu_range (<a href="GnomeApp.html" title="GnomeApp">GnomeApp</a> *app,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *path,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> start,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> items);</pre>
<p>
Same as the <a href="libgnomeui-gnome-app-helper.html#gnome-app-remove-menus"><code class="function">gnome_app_remove_menus()</code></a>, except it removes the specified number
of <em class="parameter"><code>items</code></em> from the existing <em class="parameter"><code>app</code></em>'s menu structure begining with item
described by (<em class="parameter"><code>path</code></em> plus <em class="parameter"><code>start</code></em>). This is very useful for adding and
removing Recent document items in the File menu.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>app</code></em> :</span></td>
<td> A <a href="GnomeApp.html" title="GnomeApp"><span class="type">GnomeApp</span></a> instance.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>path</code></em> :</span></td>
<td> A path to the menu item concerned.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>start</code></em> :</span></td>
<td> An offset beyond the start of <em class="parameter"><code>path</code></em> at which to begin removing.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>items</code></em> :</span></td>
<td> The number of items to remove.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2938398"></a><h3>
<a name="gnome-app-insert-menus-custom"></a>gnome_app_insert_menus_custom ()</h3>
<a class="indexterm" name="id2938412"></a><pre class="programlisting">void gnome_app_insert_menus_custom (<a href="GnomeApp.html" title="GnomeApp">GnomeApp</a> *app,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *path,
<a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo">GnomeUIInfo</a> *uiinfo,
<a href="libgnomeui-gnome-app-helper.html#GnomeUIBuilderData">GnomeUIBuilderData</a> *uibdata);</pre>
<p>
Inserts menus described by <em class="parameter"><code>uiinfo</code></em> in existing <em class="parameter"><code>app</code></em>'s menu
structure right after the item described by <em class="parameter"><code>path</code></em>. The <em class="parameter"><code>uibdata</code></em> parameter
makes this, again, most useful for language bindings.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>app</code></em> :</span></td>
<td> A <a href="GnomeApp.html" title="GnomeApp"><span class="type">GnomeApp</span></a> instance.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>path</code></em> :</span></td>
<td> A path to the menu item concerned.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>uiinfo</code></em> :</span></td>
<td> A <a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo"><span class="type">GnomeUIInfo</span></a> array describing the menus.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>uibdata</code></em> :</span></td>
<td> A <a href="libgnomeui-gnome-app-helper.html#GnomeUIBuilderData"><span class="type">GnomeUIBuilderData</span></a> instance describing the functions to attach
as the menu's callbacks.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2938578"></a><h3>
<a name="gnome-app-insert-menus"></a>gnome_app_insert_menus ()</h3>
<a class="indexterm" name="id2938590"></a><pre class="programlisting">void gnome_app_insert_menus (<a href="GnomeApp.html" title="GnomeApp">GnomeApp</a> *app,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *path,
<a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo">GnomeUIInfo</a> *menuinfo);</pre>
<p>
Insert the menus given by <em class="parameter"><code>menuinfo</code></em> beginning at <em class="parameter"><code>path</code></em> into the pre-existing
<em class="parameter"><code>app</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>app</code></em> :</span></td>
<td> A <a href="GnomeApp.html" title="GnomeApp"><span class="type">GnomeApp</span></a> instance.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>path</code></em> :</span></td>
<td> A path to the menu item concerned.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>menuinfo</code></em> :</span></td>
<td> A <a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo"><span class="type">GnomeUIInfo</span></a> array describing the menus.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2938717"></a><h3>
<a name="gnome-app-insert-menus-with-data"></a>gnome_app_insert_menus_with_data ()</h3>
<a class="indexterm" name="id2938731"></a><pre class="programlisting">void gnome_app_insert_menus_with_data
(<a href="GnomeApp.html" title="GnomeApp">GnomeApp</a> *app,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *path,
<a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo">GnomeUIInfo</a> *menuinfo,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> data);</pre>
<p>
This is the same as <a href="libgnomeui-gnome-app-helper.html#gnome-app-insert-menus"><code class="function">gnome_app_insert_menus()</code></a>, except that the specified
<em class="parameter"><code>data</code></em> is passed to each signal callback.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>app</code></em> :</span></td>
<td> A <a href="GnomeApp.html" title="GnomeApp"><span class="type">GnomeApp</span></a> instance.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>path</code></em> :</span></td>
<td> A path to the menu item concerned.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>menuinfo</code></em> :</span></td>
<td> A <a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo"><span class="type">GnomeUIInfo</span></a> array describing the menus.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>data</code></em> :</span></td>
<td> Application specific data to send to each signal callback.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2938881"></a><h3>
<a name="gnome-app-insert-menus-interp"></a>gnome_app_insert_menus_interp ()</h3>
<a class="indexterm" name="id2938895"></a><pre class="programlisting">void gnome_app_insert_menus_interp (<a href="GnomeApp.html" title="GnomeApp">GnomeApp</a> *app,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *path,
<a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo">GnomeUIInfo</a> *menuinfo,
<a
href="/usr/share/gtk-doc/html/gtk/gtk-Types.html#GtkCallbackMarshal"
>GtkCallbackMarshal</a> relay_func,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> data,
<a
href="/usr/share/gtk-doc/html/gtk/gtk-Types.html#GtkDestroyNotify"
>GtkDestroyNotify</a> destroy_func);</pre>
<p>
THe same as <a href="libgnomeui-gnome-app-helper.html#gnome-app-insert-menus"><code class="function">gnome_app_insert_menus()</code></a>, except that the given functions are
attached to each menu item. Mostly of use for language bindings.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>app</code></em> :</span></td>
<td> A <a href="GnomeApp.html" title="GnomeApp"><span class="type">GnomeApp</span></a> instance.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>path</code></em> :</span></td>
<td> A path to the menu item concerned.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>menuinfo</code></em> :</span></td>
<td> A <a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo"><span class="type">GnomeUIInfo</span></a> array describing the menus.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>relay_func</code></em> :</span></td>
<td> A custom marshallar for signal data.,
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>data</code></em> :</span></td>
<td> Application-specific data to send to each signal callback.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>destroy_func</code></em> :</span></td>
<td> The function to call when the menu item is destroyed.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2939085"></a><h3>
<a name="gnome-app-install-appbar-menu-hints"></a>gnome_app_install_appbar_menu_hints ()</h3>
<a class="indexterm" name="id2939099"></a><pre class="programlisting">void gnome_app_install_appbar_menu_hints
(<a href="GnomeAppBar.html" title="GnomeAppBar">GnomeAppBar</a> *appbar,
<a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo">GnomeUIInfo</a> *uiinfo);</pre>
<p>
Install menu hints for the given <em class="parameter"><code>appbar</code></em> object. This function cannot just
be called automatically, since it is impossible to reliably find the correct
<em class="parameter"><code>appbar</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>appbar</code></em> :</span></td>
<td> An existing <a href="GnomeAppBar.html" title="GnomeAppBar"><span class="type">GnomeAppBar</span></a> instance.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>uiinfo</code></em> :</span></td>
<td> A <a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo"><span class="type">GnomeUIInfo</span></a> array of a menu for which hints will be set.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2939200"></a><h3>
<a name="gnome-app-install-statusbar-menu-hints"></a>gnome_app_install_statusbar_menu_hints ()</h3>
<a class="indexterm" name="id2939215"></a><pre class="programlisting">void gnome_app_install_statusbar_menu_hints
(<a
href="/usr/share/gtk-doc/html/gtk/GtkStatusbar.html"
>GtkStatusbar</a> *bar,
<a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo">GnomeUIInfo</a> *uiinfo);</pre>
<p>
Install menu hints for the given status bar.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>bar</code></em> :</span></td>
<td> Pointer to <a
href="/usr/share/gtk-doc/html/gtk/GtkStatusbar.html"
><span class="type">GtkStatusbar</span></a> instance.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>uiinfo</code></em> :</span></td>
<td> <a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo"><span class="type">GnomeUIInfo</span></a> for the menu to be changed.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2939305"></a><h3>
<a name="gnome-app-install-menu-hints"></a>gnome_app_install_menu_hints ()</h3>
<a class="indexterm" name="id2939319"></a><pre class="programlisting">void gnome_app_install_menu_hints (<a href="GnomeApp.html" title="GnomeApp">GnomeApp</a> *app,
<a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo">GnomeUIInfo</a> *uiinfo);</pre>
<p>
Set menu hints for the <em class="parameter"><code>app</code></em> object's attached status bar.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>app</code></em> :</span></td>
<td> An existing <a href="GnomeAppBar.html" title="GnomeAppBar"><span class="type">GnomeAppBar</span></a> instance.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>uiinfo</code></em> :</span></td>
<td> A <a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo"><span class="type">GnomeUIInfo</span></a> array of a menu for which hints will be set.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2939413"></a><h3>
<a name="gnome-app-setup-toolbar"></a>gnome_app_setup_toolbar ()</h3>
<a class="indexterm" name="id2939426"></a><pre class="programlisting">void gnome_app_setup_toolbar (<a
href="/usr/share/gtk-doc/html/gtk/GtkToolbar.html"
>GtkToolbar</a> *toolbar,
BonoboDockItem *dock_item);</pre>
<p>
Sets up a toolbar to use GNOME user preferences.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>toolbar</code></em> :</span></td>
<td> Pointer to a <a
href="/usr/share/gtk-doc/html/gtk/GtkToolbar.html"
><span class="type">GtkToolbar</span></a> instance.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>dock_item</code></em> :</span></td>
<td> Pointer to the <span class="type">BonoboDockItem</span> the toolbar is inside, or <a
href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"
><code class="literal">NULL</code></a>
for none.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2939526"></a><h3>
<a name="GNOMEUIINFO-END:CAPS"></a>GNOMEUIINFO_END</h3>
<a class="indexterm" name="id2939539"></a><pre class="programlisting">#define GNOMEUIINFO_END</pre>
<p>
A macro that can be used to terminate an arrau of <a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo"><span class="type">GnomeUIInfo</span></a> structures.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>A <a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo"><span class="type">GnomeUIInfo</span></a> structure.
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2939585"></a><h3>
<a name="GNOMEUIINFO-SEPARATOR:CAPS"></a>GNOMEUIINFO_SEPARATOR</h3>
<a class="indexterm" name="id2939598"></a><pre class="programlisting">#define GNOMEUIINFO_SEPARATOR</pre>
<p>
A macro that defines a menu seperator bar. Can be put into an array of
<a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo"><span class="type">GnomeUIInfo</span></a> structures.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>A <a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo"><span class="type">GnomeUIInfo</span></a> structure.
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2939646"></a><h3>
<a name="GNOMEUIINFO-ITEM:CAPS"></a>GNOMEUIINFO_ITEM()</h3>
<a class="indexterm" name="id2939659"></a><pre class="programlisting">#define GNOMEUIINFO_ITEM(label, tooltip, callback, xpm_data)</pre>
<p>
A generic menu item with an inline xpm icon.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>label</code></em> :</span></td>
<td>Menu label.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>tooltip</code></em> :</span></td>
<td>Tooltip for the label.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>callback</code></em> :</span></td>
<td>Function to call on selection of this item.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>xpm_data</code></em> :</span></td>
<td>Pixmap data.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>A <a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo"><span class="type">GnomeUIInfo</span></a> structure.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2939754"></a><h3>
<a name="GNOMEUIINFO-ITEM-STOCK:CAPS"></a>GNOMEUIINFO_ITEM_STOCK()</h3>
<a class="indexterm" name="id2939767"></a><pre class="programlisting">#define GNOMEUIINFO_ITEM_STOCK(label, tooltip, callback, stock_id)</pre>
<p>
A menu item with a stock icon.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>label</code></em> :</span></td>
<td>Menu label.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>tooltip</code></em> :</span></td>
<td>Tooltip for the label.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>callback</code></em> :</span></td>
<td>Function to call on selection of this item.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>stock_id</code></em> :</span></td>
<td>The value of stock icon (from the gnome-stock-item module of this
library).
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>A <a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo"><span class="type">GnomeUIInfo</span></a> structure.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2939864"></a><h3>
<a name="GNOMEUIINFO-ITEM-NONE:CAPS"></a>GNOMEUIINFO_ITEM_NONE()</h3>
<a class="indexterm" name="id2939877"></a><pre class="programlisting">#define GNOMEUIINFO_ITEM_NONE(label, tooltip, callback)</pre>
<p>
A menu item with no icon.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>label</code></em> :</span></td>
<td>Menu label.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>tooltip</code></em> :</span></td>
<td>Tooltip for the label.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>callback</code></em> :</span></td>
<td>Function to call on selection of this item.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>A <a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo"><span class="type">GnomeUIInfo</span></a> structure.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2939958"></a><h3>
<a name="GNOMEUIINFO-ITEM-DATA:CAPS"></a>GNOMEUIINFO_ITEM_DATA()</h3>
<a class="indexterm" name="id2939971"></a><pre class="programlisting">#define GNOMEUIINFO_ITEM_DATA(label, tooltip, callback, user_data, xpm_data)</pre>
<p>
A menu item with an inline xpm icon and user data pointer for <em class="parameter"><code>callback</code></em>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>label</code></em> :</span></td>
<td>Menu label.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>tooltip</code></em> :</span></td>
<td>Tooltip for the label.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>callback</code></em> :</span></td>
<td>Function to call on selection of this item.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>user_data</code></em> :</span></td>
<td>User data to pass to the callback function.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>xpm_data</code></em> :</span></td>
<td>Pixmap data.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>A <a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo"><span class="type">GnomeUIInfo</span></a> structure.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2940088"></a><h3>
<a name="GNOMEUIINFO-TOGGLEITEM:CAPS"></a>GNOMEUIINFO_TOGGLEITEM()</h3>
<a class="indexterm" name="id2940101"></a><pre class="programlisting">#define GNOMEUIINFO_TOGGLEITEM(label, tooltip, callback, xpm_data)</pre>
<p>
A toggle item (check box) with inline xpm icon.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>label</code></em> :</span></td>
<td>Menu label.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>tooltip</code></em> :</span></td>
<td>Tooltip for the label.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>callback</code></em> :</span></td>
<td>Function to call on selection of this item.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>xpm_data</code></em> :</span></td>
<td>Pixmap data.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>A <a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo"><span class="type">GnomeUIInfo</span></a> structure.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2940197"></a><h3>
<a name="GNOMEUIINFO-TOGGLEITEM-DATA:CAPS"></a>GNOMEUIINFO_TOGGLEITEM_DATA()</h3>
<a class="indexterm" name="id2940211"></a><pre class="programlisting">#define GNOMEUIINFO_TOGGLEITEM_DATA(label, tooltip, callback, user_data, xpm_data)</pre>
<p>
A toggle item (chekc box) with inline xpm icon and user data pointer for
<em class="parameter"><code>callback</code></em>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>label</code></em> :</span></td>
<td>Menu label.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>tooltip</code></em> :</span></td>
<td>Tooltip for the label.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>callback</code></em> :</span></td>
<td>Function to call on selection of this item.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>user_data</code></em> :</span></td>
<td>User data to pass to the callback function.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>xpm_data</code></em> :</span></td>
<td>Pixmap data.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>A <a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo"><span class="type">GnomeUIInfo</span></a> structure.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2940327"></a><h3>
<a name="GNOMEUIINFO-HELP:CAPS"></a>GNOMEUIINFO_HELP()</h3>
<a class="indexterm" name="id2940340"></a><pre class="programlisting">#define GNOMEUIINFO_HELP(app_name)</pre>
<p>
A menu containing all help topics based on <em class="parameter"><code>app_name</code></em>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>app_name</code></em> :</span></td>
<td>Application id string.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>A <a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo"><span class="type">GnomeUIInfo</span></a> structure.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2940399"></a><h3>
<a name="GNOMEUIINFO-SUBTREE:CAPS"></a>GNOMEUIINFO_SUBTREE()</h3>
<a class="indexterm" name="id2940412"></a><pre class="programlisting">#define GNOMEUIINFO_SUBTREE(label, tree)</pre>
<p>
A subtree (submenu).
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>label</code></em> :</span></td>
<td>Submenu label.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>tree</code></em> :</span></td>
<td>A pointer to an array of <a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo"><span class="type">GnomeUIInfo</span></a> structures.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>A <a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo"><span class="type">GnomeUIInfo</span></a> structure.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2940487"></a><h3>
<a name="GNOMEUIINFO-SUBTREE-HINT:CAPS"></a>GNOMEUIINFO_SUBTREE_HINT()</h3>
<a class="indexterm" name="id2940501"></a><pre class="programlisting">#define GNOMEUIINFO_SUBTREE_HINT(label, hint, tree)</pre>
<p>
A subtree with a hint.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>label</code></em> :</span></td>
<td>Submenu label.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>hint</code></em> :</span></td>
<td>Hint for statusbar.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>tree</code></em> :</span></td>
<td>A pointer to an array of <a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo"><span class="type">GnomeUIInfo</span></a> structures.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>A <a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo"><span class="type">GnomeUIInfo</span></a> structure.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2940590"></a><h3>
<a name="GNOMEUIINFO-SUBTREE-STOCK:CAPS"></a>GNOMEUIINFO_SUBTREE_STOCK()</h3>
<a class="indexterm" name="id2940603"></a><pre class="programlisting">#define GNOMEUIINFO_SUBTREE_STOCK(label, tree, stock_id)</pre>
<p>
A subtree using a stock icon.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>label</code></em> :</span></td>
<td>
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>tree</code></em> :</span></td>
<td>A pointer to an array of <a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo"><span class="type">GnomeUIInfo</span></a> structs.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>stock_id</code></em> :</span></td>
<td>The value of stock icon (from the gnome-stock-item module of this
library).
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>A <a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo"><span class="type">GnomeUIInfo</span></a> structure.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2940692"></a><h3>
<a name="GNOMEUIINFO-INCLUDE:CAPS"></a>GNOMEUIINFO_INCLUDE()</h3>
<a class="indexterm" name="id2940705"></a><pre class="programlisting">#define GNOMEUIINFO_INCLUDE(tree)</pre>
<p>
A menu that should be included at the current point of the current menu (like
<a href="libgnomeui-gnome-app-helper.html#GNOMEUIINFO-SUBTREE:CAPS"><span class="type">GNOMEUIINFO_SUBTREE</span></a>, but doesn't create a submenu).
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>tree</code></em> :</span></td>
<td>A pointer to an array of <a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo"><span class="type">GnomeUIInfo</span></a> structures.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>A <a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo"><span class="type">GnomeUIInfo</span></a> structure.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2940776"></a><h3>
<a name="GNOMEUIINFO-RADIOLIST:CAPS"></a>GNOMEUIINFO_RADIOLIST()</h3>
<a class="indexterm" name="id2940789"></a><pre class="programlisting">#define GNOMEUIINFO_RADIOLIST(list)</pre>
<p>
A list of radio items.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>list</code></em> :</span></td>
<td>Pointer to a list of <a href="libgnomeui-gnome-app-helper.html#GNOMEUIINFO-RADIOITEM:CAPS"><span class="type">GNOMEUIINFO_RADIOITEM</span></a> elements.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>A <a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo"><span class="type">GnomeUIInfo</span></a> structure.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2940851"></a><h3>
<a name="GNOMEUIINFO-RADIOITEM:CAPS"></a>GNOMEUIINFO_RADIOITEM()</h3>
<a class="indexterm" name="id2940864"></a><pre class="programlisting">#define GNOMEUIINFO_RADIOITEM(label, tooltip, callback, xpm_data)</pre>
<p>
A radio item with an inline xpm icon.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>label</code></em> :</span></td>
<td>Item label.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>tooltip</code></em> :</span></td>
<td>Tooltip for the item.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>callback</code></em> :</span></td>
<td>Function to call on selection of this item.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>xpm_data</code></em> :</span></td>
<td>Pixmap data.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>A <a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo"><span class="type">GnomeUIInfo</span></a> structure.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2940960"></a><h3>
<a name="GNOMEUIINFO-RADIOITEM-DATA:CAPS"></a>GNOMEUIINFO_RADIOITEM_DATA()</h3>
<a class="indexterm" name="id2940973"></a><pre class="programlisting">#define GNOMEUIINFO_RADIOITEM_DATA(label, tooltip, callback, user_data, xpm_data)</pre>
<p>
A radio item with an inline xpm icon and user data for <em class="parameter"><code>callback</code></em>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>label</code></em> :</span></td>
<td>Item label.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>tooltip</code></em> :</span></td>
<td>Tooltip for the item.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>callback</code></em> :</span></td>
<td>Function to call on selection of this item.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>user_data</code></em> :</span></td>
<td>User data for the callback function.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>xpm_data</code></em> :</span></td>
<td>Pixmap data.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>A <a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo"><span class="type">GnomeUIInfo</span></a> structure.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2941089"></a><h3>
<a name="GNOMEUIINFO-MENU-NEW-ITEM:CAPS"></a>GNOMEUIINFO_MENU_NEW_ITEM()</h3>
<a class="indexterm" name="id2941104"></a><pre class="programlisting">#define GNOMEUIINFO_MENU_NEW_ITEM(label, tip, cb, data)</pre>
<p>
A "New" entry (typically in the "File" menu).
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>label</code></em> :</span></td>
<td>The label for the menu item (the thing being created).
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>tip</code></em> :</span></td>
<td>Tooltip for the item.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>cb</code></em> :</span></td>
<td>Callback for when the menu item is selected.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>data</code></em> :</span></td>
<td>User data to pass to the callback.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>A <a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo"><span class="type">GnomeUIInfo</span></a> structure.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2941199"></a><h3>
<a name="GNOMEUIINFO-MENU-NEW-SUBTREE:CAPS"></a>GNOMEUIINFO_MENU_NEW_SUBTREE()</h3>
<a class="indexterm" name="id2941213"></a><pre class="programlisting">#define GNOMEUIINFO_MENU_NEW_SUBTREE(tree)</pre>
<p>
A "New" menu item that creates a subtree (for when you have more than one thing
that can be created anew).
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>tree</code></em> :</span></td>
<td>Pointer to a list of <a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo"><span class="type">GnomeUIInfo</span></a> menu structures.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>A <a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo"><span class="type">GnomeUIInfo</span></a> structure.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2941275"></a><h3>
<a name="GNOMEUIINFO-MENU-OPEN-ITEM:CAPS"></a>GNOMEUIINFO_MENU_OPEN_ITEM()</h3>
<a class="indexterm" name="id2941289"></a><pre class="programlisting">#define GNOMEUIINFO_MENU_OPEN_ITEM(cb, data)</pre>
<p>
An "Open..." menu item.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>cb</code></em> :</span></td>
<td>Callback for when the menu item is selected.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>data</code></em> :</span></td>
<td>Used data to pass to the callback.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>A <a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo"><span class="type">GnomeUIInfo</span></a> structure.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2941356"></a><h3>
<a name="GNOMEUIINFO-MENU-SAVE-ITEM:CAPS"></a>GNOMEUIINFO_MENU_SAVE_ITEM()</h3>
<a class="indexterm" name="id2941369"></a><pre class="programlisting">#define GNOMEUIINFO_MENU_SAVE_ITEM(cb, data)</pre>
<p>
A "Save" menu item.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>cb</code></em> :</span></td>
<td>Callback for when the menu item is selected.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>data</code></em> :</span></td>
<td>Used data to pass to the callback.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>A <a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo"><span class="type">GnomeUIInfo</span></a> structure.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2941436"></a><h3>
<a name="GNOMEUIINFO-MENU-SAVE-AS-ITEM:CAPS"></a>GNOMEUIINFO_MENU_SAVE_AS_ITEM()</h3>
<a class="indexterm" name="id2941450"></a><pre class="programlisting">#define GNOMEUIINFO_MENU_SAVE_AS_ITEM(cb, data)</pre>
<p>
A "Save as..." menu item.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>cb</code></em> :</span></td>
<td>Callback for when the menu item is selected.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>data</code></em> :</span></td>
<td>Used data to pass to the callback.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>A <a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo"><span class="type">GnomeUIInfo</span></a> structure.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2941517"></a><h3>
<a name="GNOMEUIINFO-MENU-REVERT-ITEM:CAPS"></a>GNOMEUIINFO_MENU_REVERT_ITEM()</h3>
<a class="indexterm" name="id2941530"></a><pre class="programlisting">#define GNOMEUIINFO_MENU_REVERT_ITEM(cb, data)</pre>
<p>
A "Revert" (to last saved) menu item.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>cb</code></em> :</span></td>
<td>Callback for when the menu item is selected.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>data</code></em> :</span></td>
<td>Used data to pass to the callback.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>A <a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo"><span class="type">GnomeUIInfo</span></a> structure.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2941598"></a><h3>
<a name="GNOMEUIINFO-MENU-PRINT-ITEM:CAPS"></a>GNOMEUIINFO_MENU_PRINT_ITEM()</h3>
<a class="indexterm" name="id2941611"></a><pre class="programlisting">#define GNOMEUIINFO_MENU_PRINT_ITEM(cb, data)</pre>
<p>
A "Print" menu item.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>cb</code></em> :</span></td>
<td>Callback for when the menu item is selected.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>data</code></em> :</span></td>
<td>Used data to pass to the callback.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>A <a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo"><span class="type">GnomeUIInfo</span></a> structure.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2941678"></a><h3>
<a name="GNOMEUIINFO-MENU-PRINT-SETUP-ITEM:CAPS"></a>GNOMEUIINFO_MENU_PRINT_SETUP_ITEM()</h3>
<a class="indexterm" name="id2941693"></a><pre class="programlisting">#define GNOMEUIINFO_MENU_PRINT_SETUP_ITEM(cb, data)</pre>
<p>
A "Print setup..." menu item.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>cb</code></em> :</span></td>
<td>Callback for when the menu item is selected.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>data</code></em> :</span></td>
<td>Used data to pass to the callback.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>A <a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo"><span class="type">GnomeUIInfo</span></a> structure.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2941761"></a><h3>
<a name="GNOMEUIINFO-MENU-CLOSE-ITEM:CAPS"></a>GNOMEUIINFO_MENU_CLOSE_ITEM()</h3>
<a class="indexterm" name="id2941775"></a><pre class="programlisting">#define GNOMEUIINFO_MENU_CLOSE_ITEM(cb, data)</pre>
<p>
A "Close" menu item.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>cb</code></em> :</span></td>
<td>Callback for when the menu item is selected.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>data</code></em> :</span></td>
<td>Used data to pass to the callback.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>A <a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo"><span class="type">GnomeUIInfo</span></a> structure.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2941842"></a><h3>
<a name="GNOMEUIINFO-MENU-EXIT-ITEM:CAPS"></a>GNOMEUIINFO_MENU_EXIT_ITEM()</h3>
<a class="indexterm" name="id2941855"></a><pre class="programlisting">#define GNOMEUIINFO_MENU_EXIT_ITEM(cb, data) GNOMEUIINFO_MENU_QUIT_ITEM(cb, data)
</pre>
<p>
An "Exit" menu item (deprecated).
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>cb</code></em> :</span></td>
<td>Callback for when the menu item is selected.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>data</code></em> :</span></td>
<td>Used data to pass to the callback.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>A <a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo"><span class="type">GnomeUIInfo</span></a> structure.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2941923"></a><h3>
<a name="GNOMEUIINFO-MENU-QUIT-ITEM:CAPS"></a>GNOMEUIINFO_MENU_QUIT_ITEM()</h3>
<a class="indexterm" name="id2941937"></a><pre class="programlisting">#define GNOMEUIINFO_MENU_QUIT_ITEM(cb, data)</pre>
<p>
A "Quit" menu item.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>cb</code></em> :</span></td>
<td>Callback for when the menu item is selected.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>data</code></em> :</span></td>
<td>Used data to pass to the callback.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>A <a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo"><span class="type">GnomeUIInfo</span></a> structure.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2942004"></a><h3>
<a name="GNOMEUIINFO-MENU-CUT-ITEM:CAPS"></a>GNOMEUIINFO_MENU_CUT_ITEM()</h3>
<a class="indexterm" name="id2942018"></a><pre class="programlisting">#define GNOMEUIINFO_MENU_CUT_ITEM(cb, data)</pre>
<p>
A "Cut" menu item.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>cb</code></em> :</span></td>
<td>Callback for when the menu item is selected.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>data</code></em> :</span></td>
<td>Used data to pass to the callback.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>A <a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo"><span class="type">GnomeUIInfo</span></a> structure.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2942085"></a><h3>
<a name="GNOMEUIINFO-MENU-COPY-ITEM:CAPS"></a>GNOMEUIINFO_MENU_COPY_ITEM()</h3>
<a class="indexterm" name="id2942098"></a><pre class="programlisting">#define GNOMEUIINFO_MENU_COPY_ITEM(cb, data)</pre>
<p>
A "Copy" menu item.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>cb</code></em> :</span></td>
<td>Callback for when the menu item is selected.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>data</code></em> :</span></td>
<td>Used data to pass to the callback.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>A <a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo"><span class="type">GnomeUIInfo</span></a> structure.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2942165"></a><h3>
<a name="GNOMEUIINFO-MENU-PASTE-ITEM:CAPS"></a>GNOMEUIINFO_MENU_PASTE_ITEM()</h3>
<a class="indexterm" name="id2942178"></a><pre class="programlisting">#define GNOMEUIINFO_MENU_PASTE_ITEM(cb, data)</pre>
<p>
A "Paste" menu item.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>cb</code></em> :</span></td>
<td>Callback for when the menu item is selected.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>data</code></em> :</span></td>
<td>Used data to pass to the callback.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>A <a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo"><span class="type">GnomeUIInfo</span></a> structure.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2942245"></a><h3>
<a name="GNOMEUIINFO-MENU-SELECT-ALL-ITEM:CAPS"></a>GNOMEUIINFO_MENU_SELECT_ALL_ITEM()</h3>
<a class="indexterm" name="id2942259"></a><pre class="programlisting">#define GNOMEUIINFO_MENU_SELECT_ALL_ITEM(cb, data)</pre>
<p>
A "Select All" menu item.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>cb</code></em> :</span></td>
<td>Callback for when the menu item is selected.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>data</code></em> :</span></td>
<td>Used data to pass to the callback.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>A <a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo"><span class="type">GnomeUIInfo</span></a> structure.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2942326"></a><h3>
<a name="GNOMEUIINFO-MENU-CLEAR-ITEM:CAPS"></a>GNOMEUIINFO_MENU_CLEAR_ITEM()</h3>
<a class="indexterm" name="id2942340"></a><pre class="programlisting">#define GNOMEUIINFO_MENU_CLEAR_ITEM(cb, data)</pre>
<p>
A "clear" menu item.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>cb</code></em> :</span></td>
<td>Callback for when the menu item is selected.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>data</code></em> :</span></td>
<td>Used data to pass to the callback.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>A <a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo"><span class="type">GnomeUIInfo</span></a> structure.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2942407"></a><h3>
<a name="GNOMEUIINFO-MENU-UNDO-ITEM:CAPS"></a>GNOMEUIINFO_MENU_UNDO_ITEM()</h3>
<a class="indexterm" name="id2942420"></a><pre class="programlisting">#define GNOMEUIINFO_MENU_UNDO_ITEM(cb, data)</pre>
<p>
An "Undo" menu item.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>cb</code></em> :</span></td>
<td>Callback for when the menu item is selected.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>data</code></em> :</span></td>
<td>Used data to pass to the callback.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>A <a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo"><span class="type">GnomeUIInfo</span></a> structure.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2942487"></a><h3>
<a name="GNOMEUIINFO-MENU-REDO-ITEM:CAPS"></a>GNOMEUIINFO_MENU_REDO_ITEM()</h3>
<a class="indexterm" name="id2942501"></a><pre class="programlisting">#define GNOMEUIINFO_MENU_REDO_ITEM(cb, data)</pre>
<p>
A "Redo" menu item.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>cb</code></em> :</span></td>
<td>Callback for when the menu item is selected.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>data</code></em> :</span></td>
<td>Used data to pass to the callback.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>A <a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo"><span class="type">GnomeUIInfo</span></a> structure.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2942568"></a><h3>
<a name="GNOMEUIINFO-MENU-FIND-ITEM:CAPS"></a>GNOMEUIINFO_MENU_FIND_ITEM()</h3>
<a class="indexterm" name="id2942581"></a><pre class="programlisting">#define GNOMEUIINFO_MENU_FIND_ITEM(cb, data)</pre>
<p>
A "Find" menu item.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>cb</code></em> :</span></td>
<td>Callback for when the menu item is selected.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>data</code></em> :</span></td>
<td>Used data to pass to the callback.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>A <a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo"><span class="type">GnomeUIInfo</span></a> structure.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2942648"></a><h3>
<a name="GNOMEUIINFO-MENU-FIND-AGAIN-ITEM:CAPS"></a>GNOMEUIINFO_MENU_FIND_AGAIN_ITEM()</h3>
<a class="indexterm" name="id2942662"></a><pre class="programlisting">#define GNOMEUIINFO_MENU_FIND_AGAIN_ITEM(cb, data)</pre>
<p>
A "Find Again" menu item.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>cb</code></em> :</span></td>
<td>Callback for when the menu item is selected.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>data</code></em> :</span></td>
<td>Used data to pass to the callback.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>A <a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo"><span class="type">GnomeUIInfo</span></a> structure.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2942730"></a><h3>
<a name="GNOMEUIINFO-MENU-REPLACE-ITEM:CAPS"></a>GNOMEUIINFO_MENU_REPLACE_ITEM()</h3>
<a class="indexterm" name="id2942744"></a><pre class="programlisting">#define GNOMEUIINFO_MENU_REPLACE_ITEM(cb, data)</pre>
<p>
A "Replace" menu item.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>cb</code></em> :</span></td>
<td>Callback for when the menu item is selected.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>data</code></em> :</span></td>
<td>Used data to pass to the callback.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>A <a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo"><span class="type">GnomeUIInfo</span></a> structure.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2942811"></a><h3>
<a name="GNOMEUIINFO-MENU-PROPERTIES-ITEM:CAPS"></a>GNOMEUIINFO_MENU_PROPERTIES_ITEM()</h3>
<a class="indexterm" name="id2942825"></a><pre class="programlisting">#define GNOMEUIINFO_MENU_PROPERTIES_ITEM(cb, data)</pre>
<p>
A "Properties..." menu item.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>cb</code></em> :</span></td>
<td>Callback for when the menu item is selected.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>data</code></em> :</span></td>
<td>Used data to pass to the callback.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>A <a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo"><span class="type">GnomeUIInfo</span></a> structure.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2942893"></a><h3>
<a name="GNOMEUIINFO-MENU-PREFERENCES-ITEM:CAPS"></a>GNOMEUIINFO_MENU_PREFERENCES_ITEM()</h3>
<a class="indexterm" name="id2942906"></a><pre class="programlisting">#define GNOMEUIINFO_MENU_PREFERENCES_ITEM(cb, data)</pre>
<p>
A "Preferences..." menu item.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>cb</code></em> :</span></td>
<td>Callback for when the menu item is selected.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>data</code></em> :</span></td>
<td>Used data to pass to the callback.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>A <a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo"><span class="type">GnomeUIInfo</span></a> structure.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2942974"></a><h3>
<a name="GNOMEUIINFO-MENU-NEW-WINDOW-ITEM:CAPS"></a>GNOMEUIINFO_MENU_NEW_WINDOW_ITEM()</h3>
<a class="indexterm" name="id2942988"></a><pre class="programlisting">#define GNOMEUIINFO_MENU_NEW_WINDOW_ITEM(cb, data)</pre>
<p>
A "New Window" menu item.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>cb</code></em> :</span></td>
<td>Callback for when the menu item is selected.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>data</code></em> :</span></td>
<td>Used data to pass to the callback.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>A <a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo"><span class="type">GnomeUIInfo</span></a> structure.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2943055"></a><h3>
<a name="GNOMEUIINFO-MENU-CLOSE-WINDOW-ITEM:CAPS"></a>GNOMEUIINFO_MENU_CLOSE_WINDOW_ITEM()</h3>
<a class="indexterm" name="id2943068"></a><pre class="programlisting">#define GNOMEUIINFO_MENU_CLOSE_WINDOW_ITEM(cb, data)</pre>
<p>
A "Close Window" menu item.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>cb</code></em> :</span></td>
<td>Callback for when the menu item is selected.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>data</code></em> :</span></td>
<td>Used data to pass to the callback.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>A <a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo"><span class="type">GnomeUIInfo</span></a> structure.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2943136"></a><h3>
<a name="GNOMEUIINFO-MENU-ABOUT-ITEM:CAPS"></a>GNOMEUIINFO_MENU_ABOUT_ITEM()</h3>
<a class="indexterm" name="id2943150"></a><pre class="programlisting">#define GNOMEUIINFO_MENU_ABOUT_ITEM(cb, data)</pre>
<p>
An "About..." menu item.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>cb</code></em> :</span></td>
<td>Callback for when the menu item is selected.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>data</code></em> :</span></td>
<td>Used data to pass to the callback.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>A <a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo"><span class="type">GnomeUIInfo</span></a> structure.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2943217"></a><h3>
<a name="GNOMEUIINFO-MENU-NEW-GAME-ITEM:CAPS"></a>GNOMEUIINFO_MENU_NEW_GAME_ITEM()</h3>
<a class="indexterm" name="id2943231"></a><pre class="programlisting">#define GNOMEUIINFO_MENU_NEW_GAME_ITEM(cb, data)</pre>
<p>
A "New Game" menu item.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>cb</code></em> :</span></td>
<td>Callback for when the menu item is selected.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>data</code></em> :</span></td>
<td>Used data to pass to the callback.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>A <a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo"><span class="type">GnomeUIInfo</span></a> structure.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2943298"></a><h3>
<a name="GNOMEUIINFO-MENU-PAUSE-GAME-ITEM:CAPS"></a>GNOMEUIINFO_MENU_PAUSE_GAME_ITEM()</h3>
<a class="indexterm" name="id2943313"></a><pre class="programlisting">#define GNOMEUIINFO_MENU_PAUSE_GAME_ITEM(cb, data)</pre>
<p>
A "Pause Game" menu item.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>cb</code></em> :</span></td>
<td>Callback for when the menu item is selected.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>data</code></em> :</span></td>
<td>Used data to pass to the callback.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>A <a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo"><span class="type">GnomeUIInfo</span></a> structure.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2943380"></a><h3>
<a name="GNOMEUIINFO-MENU-RESTART-GAME-ITEM:CAPS"></a>GNOMEUIINFO_MENU_RESTART_GAME_ITEM()</h3>
<a class="indexterm" name="id2943394"></a><pre class="programlisting">#define GNOMEUIINFO_MENU_RESTART_GAME_ITEM(cb, data)</pre>
<p>
A "Restart Game" menu item.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>cb</code></em> :</span></td>
<td>Callback for when the menu item is selected.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>data</code></em> :</span></td>
<td>Used data to pass to the callback.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>A <a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo"><span class="type">GnomeUIInfo</span></a> structure.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2943461"></a><h3>
<a name="GNOMEUIINFO-MENU-UNDO-MOVE-ITEM:CAPS"></a>GNOMEUIINFO_MENU_UNDO_MOVE_ITEM()</h3>
<a class="indexterm" name="id2943476"></a><pre class="programlisting">#define GNOMEUIINFO_MENU_UNDO_MOVE_ITEM(cb, data)</pre>
<p>
An "Undo Move" menu item (for games, usually).
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>cb</code></em> :</span></td>
<td>Callback for when the menu item is selected.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>data</code></em> :</span></td>
<td>Used data to pass to the callback.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>A <a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo"><span class="type">GnomeUIInfo</span></a> structure.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2943544"></a><h3>
<a name="GNOMEUIINFO-MENU-REDO-MOVE-ITEM:CAPS"></a>GNOMEUIINFO_MENU_REDO_MOVE_ITEM()</h3>
<a class="indexterm" name="id2943558"></a><pre class="programlisting">#define GNOMEUIINFO_MENU_REDO_MOVE_ITEM(cb, data)</pre>
<p>
A "Redo move" menu item.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>cb</code></em> :</span></td>
<td>Callback for when the menu item is selected.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>data</code></em> :</span></td>
<td>Used data to pass to the callback.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>A <a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo"><span class="type">GnomeUIInfo</span></a> structure.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2943626"></a><h3>
<a name="GNOMEUIINFO-MENU-HINT-ITEM:CAPS"></a>GNOMEUIINFO_MENU_HINT_ITEM()</h3>
<a class="indexterm" name="id2943639"></a><pre class="programlisting">#define GNOMEUIINFO_MENU_HINT_ITEM(cb, data)</pre>
<p>
A "Hint" menu item.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>cb</code></em> :</span></td>
<td>Callback for when the menu item is selected.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>data</code></em> :</span></td>
<td>Used data to pass to the callback.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>A <a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo"><span class="type">GnomeUIInfo</span></a> structure.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2943706"></a><h3>
<a name="GNOMEUIINFO-MENU-SCORES-ITEM:CAPS"></a>GNOMEUIINFO_MENU_SCORES_ITEM()</h3>
<a class="indexterm" name="id2943720"></a><pre class="programlisting">#define GNOMEUIINFO_MENU_SCORES_ITEM(cb, data)</pre>
<p>
A "Scores" menu item.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>cb</code></em> :</span></td>
<td>Callback for when the menu item is selected.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>data</code></em> :</span></td>
<td>Used data to pass to the callback.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>A <a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo"><span class="type">GnomeUIInfo</span></a> structure.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2943788"></a><h3>
<a name="GNOMEUIINFO-MENU-END-GAME-ITEM:CAPS"></a>GNOMEUIINFO_MENU_END_GAME_ITEM()</h3>
<a class="indexterm" name="id2943801"></a><pre class="programlisting">#define GNOMEUIINFO_MENU_END_GAME_ITEM(cb, data)</pre>
<p>
An "End Game" menu item.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>cb</code></em> :</span></td>
<td>Callback for when the menu item is selected.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>data</code></em> :</span></td>
<td>Used data to pass to the callback.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>A <a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo"><span class="type">GnomeUIInfo</span></a> structure.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2943868"></a><h3>
<a name="GNOMEUIINFO-MENU-FILE-TREE:CAPS"></a>GNOMEUIINFO_MENU_FILE_TREE()</h3>
<a class="indexterm" name="id2943882"></a><pre class="programlisting">#define GNOMEUIINFO_MENU_FILE_TREE(tree)</pre>
<p>
A "File" menu tree.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>tree</code></em> :</span></td>
<td>Pointer to a tree containing menu items for inside this menu.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>A <a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo"><span class="type">GnomeUIInfo</span></a> structure.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2943936"></a><h3>
<a name="GNOMEUIINFO-MENU-EDIT-TREE:CAPS"></a>GNOMEUIINFO_MENU_EDIT_TREE()</h3>
<a class="indexterm" name="id2943949"></a><pre class="programlisting">#define GNOMEUIINFO_MENU_EDIT_TREE(tree)</pre>
<p>
An "Edit" menu tree.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>tree</code></em> :</span></td>
<td>Pointer to a tree containing menu items for inside this menu.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>A <a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo"><span class="type">GnomeUIInfo</span></a> structure.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2944003"></a><h3>
<a name="GNOMEUIINFO-MENU-VIEW-TREE:CAPS"></a>GNOMEUIINFO_MENU_VIEW_TREE()</h3>
<a class="indexterm" name="id2944016"></a><pre class="programlisting">#define GNOMEUIINFO_MENU_VIEW_TREE(tree)</pre>
<p>
A "View" menu tree.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>tree</code></em> :</span></td>
<td>Pointer to a tree containing menu items for inside this menu.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>A <a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo"><span class="type">GnomeUIInfo</span></a> structure.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2944070"></a><h3>
<a name="GNOMEUIINFO-MENU-SETTINGS-TREE:CAPS"></a>GNOMEUIINFO_MENU_SETTINGS_TREE()</h3>
<a class="indexterm" name="id2944083"></a><pre class="programlisting">#define GNOMEUIINFO_MENU_SETTINGS_TREE(tree)</pre>
<p>
A "Settings" menu tree.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>tree</code></em> :</span></td>
<td>Pointer to a tree containing menu items for inside this menu.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>A <a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo"><span class="type">GnomeUIInfo</span></a> structure.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2944137"></a><h3>
<a name="GNOMEUIINFO-MENU-FILES-TREE:CAPS"></a>GNOMEUIINFO_MENU_FILES_TREE()</h3>
<a class="indexterm" name="id2944151"></a><pre class="programlisting">#define GNOMEUIINFO_MENU_FILES_TREE(tree)</pre>
<p>
A "Files" menu tree.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>tree</code></em> :</span></td>
<td>Pointer to a tree containing menu items for inside this menu.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>A <a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo"><span class="type">GnomeUIInfo</span></a> structure.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2944204"></a><h3>
<a name="GNOMEUIINFO-MENU-WINDOWS-TREE:CAPS"></a>GNOMEUIINFO_MENU_WINDOWS_TREE()</h3>
<a class="indexterm" name="id2944218"></a><pre class="programlisting">#define GNOMEUIINFO_MENU_WINDOWS_TREE(tree)</pre>
<p>
A "Windows" menu tree.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>tree</code></em> :</span></td>
<td>Pointer to a tree containing menu items for inside this menu.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>A <a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo"><span class="type">GnomeUIInfo</span></a> structure.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2944272"></a><h3>
<a name="GNOMEUIINFO-MENU-HELP-TREE:CAPS"></a>GNOMEUIINFO_MENU_HELP_TREE()</h3>
<a class="indexterm" name="id2944285"></a><pre class="programlisting">#define GNOMEUIINFO_MENU_HELP_TREE(tree)</pre>
<p>
A "Help" menu tree.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>tree</code></em> :</span></td>
<td>Pointer to a tree containing menu items for inside this menu.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>A <a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo"><span class="type">GnomeUIInfo</span></a> structure.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2944339"></a><h3>
<a name="GNOMEUIINFO-MENU-GAME-TREE:CAPS"></a>GNOMEUIINFO_MENU_GAME_TREE()</h3>
<a class="indexterm" name="id2944352"></a><pre class="programlisting">#define GNOMEUIINFO_MENU_GAME_TREE(tree)</pre>
<p>
A "Game" menu tree.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>tree</code></em> :</span></td>
<td>Pointer to a tree containing menu items for inside this menu.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>A <a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo"><span class="type">GnomeUIInfo</span></a> structure.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2944406"></a><h3>
<a name="GNOME-MENU-FILE-STRING:CAPS"></a>GNOME_MENU_FILE_STRING</h3>
<a class="indexterm" name="id2944419"></a><pre class="programlisting">#define GNOME_MENU_FILE_STRING D_("_File")
</pre>
<p>
A string which is the title of the "File" menu (when the menu is created using
<a href="libgnomeui-gnome-app-helper.html#GNOMEUIINFO-MENU-FILE-TREE:CAPS"><span class="type">GNOMEUIINFO_MENU_FILE_TREE</span></a>).
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>A <a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo"><span class="type">GnomeUIInfo</span></a> structure.
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2944467"></a><h3>
<a name="GNOME-MENU-FILE-PATH:CAPS"></a>GNOME_MENU_FILE_PATH</h3>
<a class="indexterm" name="id2944481"></a><pre class="programlisting">#define GNOME_MENU_FILE_PATH D_("_File/")
</pre>
<p>
A pre-defined path to the "File" menu (when the menu is created using
<a href="libgnomeui-gnome-app-helper.html#GNOMEUIINFO-MENU-FILE-TREE:CAPS"><span class="type">GNOMEUIINFO_MENU_FILE_TREE</span></a>). Used in calls like <a href="libgnomeui-gnome-app-helper.html#gnome-app-find-menu-pos"><code class="function">gnome_app_find_menu_pos()</code></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>A <a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo"><span class="type">GnomeUIInfo</span></a> structure.
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2944540"></a><h3>
<a name="GNOME-MENU-EDIT-STRING:CAPS"></a>GNOME_MENU_EDIT_STRING</h3>
<a class="indexterm" name="id2944553"></a><pre class="programlisting">#define GNOME_MENU_EDIT_STRING D_("_Edit")
</pre>
<p>
A string which is the title of the "Edit" menu (when the menu is created using
<a href="libgnomeui-gnome-app-helper.html#GNOMEUIINFO-MENU-FILE-TREE:CAPS"><span class="type">GNOMEUIINFO_MENU_FILE_TREE</span></a>).
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>A <a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo"><span class="type">GnomeUIInfo</span></a> structure.
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2944602"></a><h3>
<a name="GNOME-MENU-EDIT-PATH:CAPS"></a>GNOME_MENU_EDIT_PATH</h3>
<a class="indexterm" name="id2944614"></a><pre class="programlisting">#define GNOME_MENU_EDIT_PATH D_("_Edit/")
</pre>
<p>
A pre-defined path to the "Edit" menu (when the menu is created using
<a href="libgnomeui-gnome-app-helper.html#GNOMEUIINFO-MENU-EDIT-TREE:CAPS"><span class="type">GNOMEUIINFO_MENU_EDIT_TREE</span></a>). Used in calls like <a href="libgnomeui-gnome-app-helper.html#gnome-app-find-menu-pos"><code class="function">gnome_app_find_menu_pos()</code></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>A <a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo"><span class="type">GnomeUIInfo</span></a> structure.
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2944674"></a><h3>
<a name="GNOME-MENU-VIEW-STRING:CAPS"></a>GNOME_MENU_VIEW_STRING</h3>
<a class="indexterm" name="id2944688"></a><pre class="programlisting">#define GNOME_MENU_VIEW_STRING D_("_View")
</pre>
<p>
A string which is the title of the "View" menu (when the menu is created using
<a href="libgnomeui-gnome-app-helper.html#GNOMEUIINFO-MENU-VIEW-TREE:CAPS"><span class="type">GNOMEUIINFO_MENU_VIEW_TREE</span></a>).
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>A <a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo"><span class="type">GnomeUIInfo</span></a> structure.
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2944736"></a><h3>
<a name="GNOME-MENU-VIEW-PATH:CAPS"></a>GNOME_MENU_VIEW_PATH</h3>
<a class="indexterm" name="id2944749"></a><pre class="programlisting">#define GNOME_MENU_VIEW_PATH D_("_View/")
</pre>
<p>
A pre-defined path to the "View" menu (when the menu is created using
<a href="libgnomeui-gnome-app-helper.html#GNOMEUIINFO-MENU-FILE-TREE:CAPS"><span class="type">GNOMEUIINFO_MENU_FILE_TREE</span></a>). Used in calls like <a href="libgnomeui-gnome-app-helper.html#gnome-app-find-menu-pos"><code class="function">gnome_app_find_menu_pos()</code></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>A <a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo"><span class="type">GnomeUIInfo</span></a> structure.
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2944809"></a><h3>
<a name="GNOME-MENU-SETTINGS-STRING:CAPS"></a>GNOME_MENU_SETTINGS_STRING</h3>
<a class="indexterm" name="id2944822"></a><pre class="programlisting">#define GNOME_MENU_SETTINGS_STRING D_("_Settings")
</pre>
<p>
A string which is the title of the "Settings" menu (when the menu is created
using <a href="libgnomeui-gnome-app-helper.html#GNOMEUIINFO-MENU-SETTINGS-TREE:CAPS"><span class="type">GNOMEUIINFO_MENU_SETTINGS_TREE</span></a>).
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>A <a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo"><span class="type">GnomeUIInfo</span></a> structure.
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2944870"></a><h3>
<a name="GNOME-MENU-SETTINGS-PATH:CAPS"></a>GNOME_MENU_SETTINGS_PATH</h3>
<a class="indexterm" name="id2944885"></a><pre class="programlisting">#define GNOME_MENU_SETTINGS_PATH D_("_Settings/")
</pre>
<p>
A pre-defined path to the "Settings" menu (when the menu is created using
<a href="libgnomeui-gnome-app-helper.html#GNOMEUIINFO-MENU-FILE-TREE:CAPS"><span class="type">GNOMEUIINFO_MENU_FILE_TREE</span></a>). Used in calls like <a href="libgnomeui-gnome-app-helper.html#gnome-app-find-menu-pos"><code class="function">gnome_app_find_menu_pos()</code></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>A <a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo"><span class="type">GnomeUIInfo</span></a> structure.
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2944945"></a><h3>
<a name="GNOME-MENU-NEW-STRING:CAPS"></a>GNOME_MENU_NEW_STRING</h3>
<a class="indexterm" name="id2944958"></a><pre class="programlisting">#define GNOME_MENU_NEW_STRING D_("_New")
</pre>
<p>
A string which is the title of the "New" menu (when the menu is created using
<span class="type">GNOMEUIINFO_MENU_NEW_TREE</span>).
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>A <a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo"><span class="type">GnomeUIInfo</span></a> structure.
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2945007"></a><h3>
<a name="GNOME-MENU-NEW-PATH:CAPS"></a>GNOME_MENU_NEW_PATH</h3>
<a class="indexterm" name="id2945021"></a><pre class="programlisting">#define GNOME_MENU_NEW_PATH D_("_New/")
</pre>
<p>
A pre-defined path to the "New" menu (when the menu is created using
<a href="libgnomeui-gnome-app-helper.html#GNOMEUIINFO-MENU-FILE-TREE:CAPS"><span class="type">GNOMEUIINFO_MENU_FILE_TREE</span></a>). Used in calls like <a href="libgnomeui-gnome-app-helper.html#gnome-app-find-menu-pos"><code class="function">gnome_app_find_menu_pos()</code></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>A <a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo"><span class="type">GnomeUIInfo</span></a> structure.
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2945080"></a><h3>
<a name="GNOME-MENU-FILES-STRING:CAPS"></a>GNOME_MENU_FILES_STRING</h3>
<a class="indexterm" name="id2945094"></a><pre class="programlisting">#define GNOME_MENU_FILES_STRING D_("Fi_les")
</pre>
<p>
A string which is the title of the "Files" menu (when the menu is created using
<a href="libgnomeui-gnome-app-helper.html#GNOMEUIINFO-MENU-FILES-TREE:CAPS"><span class="type">GNOMEUIINFO_MENU_FILES_TREE</span></a>).
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>A <a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo"><span class="type">GnomeUIInfo</span></a> structure.
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2945142"></a><h3>
<a name="GNOME-MENU-FILES-PATH:CAPS"></a>GNOME_MENU_FILES_PATH</h3>
<a class="indexterm" name="id2945155"></a><pre class="programlisting">#define GNOME_MENU_FILES_PATH D_("Fi_les/")
</pre>
<p>
A pre-defined path to the "Files" menu (when the menu is created using
<a href="libgnomeui-gnome-app-helper.html#GNOMEUIINFO-MENU-FILE-TREE:CAPS"><span class="type">GNOMEUIINFO_MENU_FILE_TREE</span></a>). Used in calls like <a href="libgnomeui-gnome-app-helper.html#gnome-app-find-menu-pos"><code class="function">gnome_app_find_menu_pos()</code></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>A <a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo"><span class="type">GnomeUIInfo</span></a> structure.
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2945215"></a><h3>
<a name="GNOME-MENU-WINDOWS-STRING:CAPS"></a>GNOME_MENU_WINDOWS_STRING</h3>
<a class="indexterm" name="id2945229"></a><pre class="programlisting">#define GNOME_MENU_WINDOWS_STRING D_("_Windows")
</pre>
<p>
A string which is the title of the "Windows" menu (when the menu is created
using <a href="libgnomeui-gnome-app-helper.html#GNOMEUIINFO-MENU-WINDOWS-TREE:CAPS"><span class="type">GNOMEUIINFO_MENU_WINDOWS_TREE</span></a>).
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>A <a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo"><span class="type">GnomeUIInfo</span></a> structure.
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2945277"></a><h3>
<a name="GNOME-MENU-WINDOWS-PATH:CAPS"></a>GNOME_MENU_WINDOWS_PATH</h3>
<a class="indexterm" name="id2945291"></a><pre class="programlisting">#define GNOME_MENU_WINDOWS_PATH D_("_Windows/")
</pre>
<p>
A pre-defined path to the "Windows" menu (when the menu is created using
<a href="libgnomeui-gnome-app-helper.html#GNOMEUIINFO-MENU-FILE-TREE:CAPS"><span class="type">GNOMEUIINFO_MENU_FILE_TREE</span></a>). Used in calls like <a href="libgnomeui-gnome-app-helper.html#gnome-app-find-menu-pos"><code class="function">gnome_app_find_menu_pos()</code></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>A <a href="libgnomeui-gnome-app-helper.html#GnomeUIInfo"><span class="type">GnomeUIInfo</span></a> structure.
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2945351"></a><h3>
<a name="gnome-app-helper-gettext"></a>gnome_app_helper_gettext ()</h3>
<a class="indexterm" name="id2945364"></a><pre class="programlisting">const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a>* gnome_app_helper_gettext (const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *string);</pre>
<p>
Translate <em class="parameter"><code>string</code></em> by calling <a
href="/usr/share/gtk-doc/html/libbonobo/libbonobo-bonobo-i18n.html#gettext"
><code class="function">gettext()</code></a> and then, if that did not change the
string, <a
href="/usr/share/gtk-doc/html/libbonobo/libbonobo-bonobo-i18n.html#dgettext"
><code class="function">dgettext()</code></a> with the domain set to libgnome's message domain.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>string</code></em> :</span></td>
<td>The string to translate.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>The localised value of the string.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2945454"></a><h3>
<a name="L-:CAPS"></a>L_()</h3>
<a class="indexterm" name="id2945466"></a><pre class="programlisting">#define L_(x)</pre>
<p>
Syntactic sugar for <a href="libgnomeui-gnome-app-helper.html#gnome-app-helper-gettext"><code class="function">gnome_app_helper_gettext()</code></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td>
<span class="term"><em class="parameter"><code>x</code></em> :</span></td>
<td>
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2945510"></a><h3>
<a name="D-:CAPS"></a>D_()</h3>
<a class="indexterm" name="id2945522"></a><pre class="programlisting">#define D_(x)</pre>
<p>
Syntactic sugar for calling <a
href="/usr/share/gtk-doc/html/libbonobo/libbonobo-bonobo-i18n.html#dgettext"
><code class="function">dgettext()</code></a> with the domain set to libgnome's message
domain.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td>
<span class="term"><em class="parameter"><code>x</code></em> :</span></td>
<td>
</td>
</tr></tbody>
</table></div>
</div>
</div>
</div>
</body>
</html>