<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN">
<HTML
><HEAD
><TITLE
>Functions provided by GnomeAppHelper</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.74b"><LINK
REL="HOME"
TITLE="Gnome Developers' Information"
HREF="book1.html"><LINK
REL="UP"
TITLE="Automatic menu and toolbar creation with GnomeAppHelper"
HREF="gnome-app-helper.html"><LINK
REL="PREVIOUS"
TITLE="Format information for the configuration of keybindings
for standard mens"
HREF="gnome-app-helper-keybindings-config.html"><LINK
REL="NEXT"
TITLE="The GnomeCanvas widget"
HREF="gnome-canvas.html"></HEAD
><BODY
CLASS="SECT1"
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><DIV
CLASS="NAVHEADER"
><TABLE
SUMMARY="Header navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TH
COLSPAN="3"
ALIGN="center"
>Gnome Developers' Information</TH
></TR
><TR
><TD
WIDTH="10%"
ALIGN="left"
VALIGN="bottom"
><A
HREF="gnome-app-helper-keybindings-config.html"
ACCESSKEY="P"
><<< Previous</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
>Automatic menu and toolbar creation with GnomeAppHelper</TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="gnome-canvas.html"
ACCESSKEY="N"
>Next >>></A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><DIV
CLASS="SECT1"
><H1
CLASS="SECT1"
><A
NAME="GNOME-APP-HELPER-FUNCTIONS"
>Functions provided by GnomeAppHelper</A
></H1
><P
> The following is a list of the functions provided by
GnomeAppHelper.
</P
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="GNOME-APP-FIND-MENU-POS"
>gnome_app_find_menu_pos - return position of a menu item</A
></H2
><DIV
CLASS="FUNCSYNOPSIS"
><A
NAME="AEN1805"
></A
><P
></P
><CODE
CLASS="FUNCDEF"
>GtkWidget *<TT
CLASS="FUNCTION"
>gnome_app_find_menu_pos</TT
></CODE
>(GtkWidget *<TT
CLASS="PARAMETER"
><I
>root</I
></TT
>, gchar *<TT
CLASS="PARAMETER"
><I
>path</I
></TT
>, gint *<TT
CLASS="PARAMETER"
><I
>pos</I
></TT
>);<P
></P
></DIV
><DIV
CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="AEN1814"
>Description</A
></H3
><P
>For a menu item specified by <TT
CLASS="PARAMETER"
><I
>path</I
></TT
>, returns item's parent
GtkMenuShell and sets *pos to item's position in it if the item is found in the
menu tree starting in GtkMenuShell root and NULL otherwise. New menus can later be
inserted after the menu-item with a call to:
<TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
> gtk_menu_shell_insert(GTK_MENU_SHELL(parent), new_item, pos);
</PRE
></TD
></TR
></TABLE
>
</P
></DIV
><DIV
CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="AEN1819"
>Usage</A
></H3
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
> GnomeApp *app;
GtkWidget *shell;
gint pos;
shell = gnome_app_find_menu_pos(app->menubar, "Edit/Sort/Ascending", &pos);
</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="AEN1822"
>Parameters</A
></H3
><P
></P
><UL
><LI
><P
>GtkWidget *<TT
CLASS="PARAMETER"
><I
>root</I
></TT
>
</P
><P
>The menu shell at the root of the menu subtree that is to be searched.
</P
></LI
><LI
><P
>gchar *<TT
CLASS="PARAMETER"
><I
>path</I
></TT
>
</P
><P
>Menu path describing the searched-for item.
<P
></P
><UL
><LI
><P
>the path argument should be in the form "File/.../.../ItemName".
</P
></LI
><LI
><P
> "" will return position before the first item
in <TT
CLASS="PARAMETER"
><I
>root</I
></TT
>.
</P
></LI
><LI
><P
>"File/" will return position before the first
item of the File submenu.
</P
></LI
><LI
><P
> "File/Settings" will return position after the
Settings item in the File submenu.
</P
></LI
><LI
><P
>use of "File/<Separator>" should be obvious. However this stops
after the first separator.
</P
></LI
></UL
>
</P
></LI
><LI
><P
>gint *<TT
CLASS="PARAMETER"
><I
>pos</I
></TT
>
</P
><P
>The integer pointed to by this parameter is set to the position of the
menu item described by <TT
CLASS="PARAMETER"
><I
>path</I
></TT
> in its parent menu shell.
</P
></LI
></UL
></DIV
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="GNOME-APP-REMOVE-MENUS"
>gnome_app_remove_menus - remove a number of menu items</A
></H2
><DIV
CLASS="FUNCSYNOPSIS"
><A
NAME="AEN1852"
></A
><P
></P
><CODE
CLASS="FUNCDEF"
>void <TT
CLASS="FUNCTION"
>gnome_app_remove_menus</TT
></CODE
>(GnomeApp *<TT
CLASS="PARAMETER"
><I
>app</I
></TT
>, gchar *<TT
CLASS="PARAMETER"
><I
>path</I
></TT
>, gint <TT
CLASS="PARAMETER"
><I
>item_count</I
></TT
>);<P
></P
></DIV
><DIV
CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="AEN1861"
>Description</A
></H3
><P
>This function removes <TT
CLASS="PARAMETER"
><I
>item_count</I
></TT
> items
from GnomeApp's menu structure, beginning with item described by
<TT
CLASS="PARAMETER"
><I
>path</I
></TT
>.
</P
></DIV
><DIV
CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="AEN1866"
>Usage</A
></H3
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
> gnome_app_remove_menus(app, "Edit/Sort/Ascending", 2);
</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="AEN1869"
>Parameters</A
></H3
><P
></P
><UL
><LI
><P
>GnomeApp *<TT
CLASS="PARAMETER"
><I
>app</I
></TT
>
</P
><P
>The GnomeApp widget with the menubar containing the items to be removed.
</P
></LI
><LI
><P
>gchar *<TT
CLASS="PARAMETER"
><I
>path</I
></TT
>
</P
><P
>Path describing the first item to be removed. See
<TT
CLASS="FUNCTION"
>gnome_app_find_menu_pos</TT
> for more information on menu paths.
</P
></LI
><LI
><P
>gint <TT
CLASS="PARAMETER"
><I
>item_count</I
></TT
>
</P
><P
>Number of subsequent items to remove.
</P
></LI
></UL
></DIV
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="GNOME-APP-INSERT-MENUS"
>gnome_app_insert_menus - insert menu structure in a GnomeApp's menubar</A
></H2
><DIV
CLASS="FUNCSYNOPSIS"
><A
NAME="AEN1887"
></A
><P
></P
><CODE
CLASS="FUNCDEF"
>void <TT
CLASS="FUNCTION"
>gnome_app_insert_menus</TT
></CODE
>(GnomeApp *<TT
CLASS="PARAMETER"
><I
>app</I
></TT
>, gchar *<TT
CLASS="PARAMETER"
><I
>path</I
></TT
>, GnomeUIInfo *<TT
CLASS="PARAMETER"
><I
>uiinfo</I
></TT
>);<P
></P
></DIV
><DIV
CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="AEN1896"
>Description</A
></H3
><P
>Inserts menu structure described by <TT
CLASS="PARAMETER"
><I
>uiinfo</I
></TT
> at position
described by <TT
CLASS="PARAMETER"
><I
>path</I
></TT
>.
</P
></DIV
><DIV
CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="AEN1901"
>Usage</A
></H3
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
> static GnomeUIInfo edit_menu[] = {
{ GNOME_APP_UI_ITEM, N_("_Copy"), N_("Copy text"), copy_callback, NULL, NULL,
GNOME_APP_PIXMAP_STOCK, GNOME_STOCK_MENU_COPY, 'c', GDK_CONTROL_MASK, NULL },
{ GNOME_APP_UI_ITEM, N_("C_ut..."), N_("Cut text"), cut_callback, NULL, NULL,
GNOME_APP_PIXMAP_STOCK, GNOME_STOCK_MENU_CUT, 'x', GDK_CONTROL_MASK, NULL },
{ GNOME_APP_UI_ITEM, N_("_Paste"), N_("Paste clipboard contents"), paste_callback, NULL, NULL,
GNOME_APP_PIXMAP_STOCK, GNOME_STOCK_MENU_PASTE, 'v', GDK_CONTROL_MASK, NULL },
GNOMEUIINFO_END
};
static GnomeUIInfo more_menus[] = {
{ GNOME_APP_UI_ITEM, N_("_Search..."), N_("Search for text"), search_callback, NULL, NULL,
GNOME_APP_PIXMAP_NONE, NULL, 's', GDK_CONTROL_MASK, NULL },
{ GNOME_APP_UI_ITEM, N_("_Replace..."), N_("Replace text"), replace_callback, NULL, NULL,
GNOME_APP_PIXMAP_NONE, NULL, 'r', GDK_CONTROL_MASK, NULL },
GNOMEUIINFO_END
};
static GnomeUIInfo main_menu[] = {
GNOMEUIINFO_SUBTREE (N_("_Edit"), edit_menu),
GNOMEUIINFO_END
};
app = gnome_app_new("app", "App");
gnome_app_create_menus(app, main_menu);
/* do something */
/* insert Search and Replace items after Paste */
gnome_app_insert_menus(app, "Edit/Paste", sort_menu);
</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="AEN1904"
>Parameters</A
></H3
><P
></P
><UL
><LI
><P
>GnomeApp *<TT
CLASS="PARAMETER"
><I
>app</I
></TT
>
</P
><P
>The GnomeApp containing the menubar in which the new items will
be inserted.
</P
></LI
><LI
><P
>gchar *<TT
CLASS="PARAMETER"
><I
>path</I
></TT
>
</P
><P
>Path describing the position where the new items will be insterted. See
<TT
CLASS="FUNCTION"
>gnome_app_find_menu_pos</TT
> for more information on menu paths.
</P
></LI
><LI
><P
>GnomeUIInfo *<TT
CLASS="PARAMETER"
><I
>uiinfo</I
></TT
>
</P
><P
>A pointer to an array of GnomeUIInfo entries describing the menu items
to insert.
</P
></LI
></UL
></DIV
></DIV
></DIV
><DIV
CLASS="NAVFOOTER"
><HR
ALIGN="LEFT"
WIDTH="100%"><TABLE
SUMMARY="Footer navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
><A
HREF="gnome-app-helper-keybindings-config.html"
ACCESSKEY="P"
><<< Previous</A
></TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="book1.html"
ACCESSKEY="H"
>Home</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
><A
HREF="gnome-canvas.html"
ACCESSKEY="N"
>Next >>></A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>Format information for the configuration of keybindings
for standard mens</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="gnome-app-helper.html"
ACCESSKEY="U"
>Up</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>The <SPAN
CLASS="TYPE"
>GnomeCanvas</SPAN
> widget</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>
distrib
>
Mandriva
>
2010.0
>
i586
>
media
>
contrib-release
>
by-pkgid
>
1bbf51ece72e40a5f40ad48678e7c5a5
>
files
>
236
