<HTML
><HEAD
><TITLE
>GnomeApp</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.44"><LINK
REL="HOME"
TITLE="Gnome User Interface Library Reference Manual"
HREF="book1.html"><LINK
REL="UP"
TITLE="GNOME Widgets and Objects"
HREF="gnome-objects.html"><LINK
REL="PREVIOUS"
TITLE="GnomeAnimator"
HREF="gnomeanimator.html"><LINK
REL="NEXT"
TITLE="GnomeAppBar"
HREF="gnomeappbar.html"></HEAD
><BODY
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><DIV
CLASS="NAVHEADER"
><TABLE
WIDTH="100%"
BORDER="0"
BGCOLOR="#000000"
CELLPADDING="1"
CELLSPACING="0"
><TR
><TH
COLSPAN="4"
ALIGN="center"
><FONT
COLOR="#FFFFFF"
SIZE="5"
>Gnome User Interface Library Reference Manual</FONT
></TH
></TR
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomeanimator.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>&#60;&#60;&#60; Previous Page</B
></FONT
></A
></TD
><TD
WIDTH="25%"
BGCOLOR="#0000C0"
ALIGN="center"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
><A
HREF="book1.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Home</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#00C000"
ALIGN="center"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
><A
HREF="gnome-objects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomeappbar.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Next Page &#62;&#62;&#62;</B
></FONT
></A
></TD
></TR
></TABLE
></DIV
><H1
><A
NAME="GNOMEAPP"
>GnomeApp</A
></H1
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN8940"
></A
><H2
>Name</H2
>GnomeApp&nbsp;--&nbsp;The toplevel GNOME container</DIV
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN8943"
></A
><H2
>Synopsis</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;#include &lt;gnome.h&gt;


struct      <A
HREF="gnomeapp.html#GNOMEAPP-STRUCT"
>GnomeApp</A
>;
<GTKDOCLINK
HREF="GTKWIDGET"
>GtkWidget</GTKDOCLINK
>*  <A
HREF="gnomeapp.html#GNOME-APP-NEW"
>gnome_app_new</A
>                   (<GTKDOCLINK
HREF="GCHAR"
>gchar</GTKDOCLINK
> *appname,
                                             char *title);
void        <A
HREF="gnomeapp.html#GNOME-APP-CONSTRUCT"
>gnome_app_construct</A
>             (<A
HREF="gnomeapp.html"
>GnomeApp</A
> *app,
                                             <GTKDOCLINK
HREF="GCHAR"
>gchar</GTKDOCLINK
> *appname,
                                             char *title);
#define     <A
HREF="gnomeapp.html#GNOME-APP-MENUBAR-NAME"
>GNOME_APP_MENUBAR_NAME</A
>
#define     <A
HREF="gnomeapp.html#GNOME-APP-TOOLBAR-NAME"
>GNOME_APP_TOOLBAR_NAME</A
>
void        <A
HREF="gnomeapp.html#GNOME-APP-SET-MENUS"
>gnome_app_set_menus</A
>             (<A
HREF="gnomeapp.html"
>GnomeApp</A
> *app,
                                             <GTKDOCLINK
HREF="GTKMENUBAR"
>GtkMenuBar</GTKDOCLINK
> *menubar);
void        <A
HREF="gnomeapp.html#GNOME-APP-SET-TOOLBAR"
>gnome_app_set_toolbar</A
>           (<A
HREF="gnomeapp.html"
>GnomeApp</A
> *app,
                                             <GTKDOCLINK
HREF="GTKTOOLBAR"
>GtkToolbar</GTKDOCLINK
> *toolbar);
void        <A
HREF="gnomeapp.html#GNOME-APP-SET-STATUSBAR"
>gnome_app_set_statusbar</A
>         (<A
HREF="gnomeapp.html"
>GnomeApp</A
> *app,
                                             <GTKDOCLINK
HREF="GTKWIDGET"
>GtkWidget</GTKDOCLINK
> *statusbar);
void        <A
HREF="gnomeapp.html#GNOME-APP-SET-CONTENTS"
>gnome_app_set_contents</A
>          (<A
HREF="gnomeapp.html"
>GnomeApp</A
> *app,
                                             <GTKDOCLINK
HREF="GTKWIDGET"
>GtkWidget</GTKDOCLINK
> *contents);
void        <A
HREF="gnomeapp.html#GNOME-APP-ADD-TOOLBAR"
>gnome_app_add_toolbar</A
>           (<A
HREF="gnomeapp.html"
>GnomeApp</A
> *app,
                                             <GTKDOCLINK
HREF="GTKTOOLBAR"
>GtkToolbar</GTKDOCLINK
> *toolbar,
                                             const <GTKDOCLINK
HREF="GCHAR"
>gchar</GTKDOCLINK
> *name,
                                             <A
HREF="gnomedockitem.html#GNOMEDOCKITEMBEHAVIOR"
>GnomeDockItemBehavior</A
> behavior,
                                             <A
HREF="gnomedock.html#GNOMEDOCKPLACEMENT"
>GnomeDockPlacement</A
> placement,
                                             <GTKDOCLINK
HREF="GINT"
>gint</GTKDOCLINK
> band_num,
                                             <GTKDOCLINK
HREF="GINT"
>gint</GTKDOCLINK
> band_position,
                                             <GTKDOCLINK
HREF="GINT"
>gint</GTKDOCLINK
> offset);
void        <A
HREF="gnomeapp.html#GNOME-APP-ADD-DOCKED"
>gnome_app_add_docked</A
>            (<A
HREF="gnomeapp.html"
>GnomeApp</A
> *app,
                                             <GTKDOCLINK
HREF="GTKWIDGET"
>GtkWidget</GTKDOCLINK
> *widget,
                                             const <GTKDOCLINK
HREF="GCHAR"
>gchar</GTKDOCLINK
> *name,
                                             <A
HREF="gnomedockitem.html#GNOMEDOCKITEMBEHAVIOR"
>GnomeDockItemBehavior</A
> behavior,
                                             <A
HREF="gnomedock.html#GNOMEDOCKPLACEMENT"
>GnomeDockPlacement</A
> placement,
                                             <GTKDOCLINK
HREF="GINT"
>gint</GTKDOCLINK
> band_num,
                                             <GTKDOCLINK
HREF="GINT"
>gint</GTKDOCLINK
> band_position,
                                             <GTKDOCLINK
HREF="GINT"
>gint</GTKDOCLINK
> offset);
void        <A
HREF="gnomeapp.html#GNOME-APP-ADD-DOCK-ITEM"
>gnome_app_add_dock_item</A
>         (<A
HREF="gnomeapp.html"
>GnomeApp</A
> *app,
                                             <A
HREF="gnomedockitem.html"
>GnomeDockItem</A
> *item,
                                             <A
HREF="gnomedock.html#GNOMEDOCKPLACEMENT"
>GnomeDockPlacement</A
> placement,
                                             <GTKDOCLINK
HREF="GINT"
>gint</GTKDOCLINK
> band_num,
                                             <GTKDOCLINK
HREF="GINT"
>gint</GTKDOCLINK
> band_position,
                                             <GTKDOCLINK
HREF="GINT"
>gint</GTKDOCLINK
> offset);
void        <A
HREF="gnomeapp.html#GNOME-APP-ENABLE-LAYOUT-CONFIG"
>gnome_app_enable_layout_config</A
>  (<A
HREF="gnomeapp.html"
>GnomeApp</A
> *app,
                                             <GTKDOCLINK
HREF="GBOOLEAN"
>gboolean</GTKDOCLINK
> enable);
<A
HREF="gnomedock.html"
>GnomeDock</A
>*  <A
HREF="gnomeapp.html#GNOME-APP-GET-DOCK"
>gnome_app_get_dock</A
>              (<A
HREF="gnomeapp.html"
>GnomeApp</A
> *app);
<A
HREF="gnomedockitem.html"
>GnomeDockItem</A
>* <A
HREF="gnomeapp.html#GNOME-APP-GET-DOCK-ITEM-BY-NAME"
>gnome_app_get_dock_item_by_name</A
>
                                            (<A
HREF="gnomeapp.html"
>GnomeApp</A
> *app,
                                             const <GTKDOCLINK
HREF="GCHAR"
>gchar</GTKDOCLINK
> *name);&#13;</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN9002"
></A
><H2
>Object Hierarchy</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;  <GTKDOCLINK
HREF="GTKOBJECT"
>GtkObject</GTKDOCLINK
>
   +----<GTKDOCLINK
HREF="GTKWIDGET"
>GtkWidget</GTKDOCLINK
>
         +----<GTKDOCLINK
HREF="GTKCONTAINER"
>GtkContainer</GTKDOCLINK
>
               +----<GTKDOCLINK
HREF="GTKBIN"
>GtkBin</GTKDOCLINK
>
                     +----<GTKDOCLINK
HREF="GTKWINDOW"
>GtkWindow</GTKDOCLINK
>
                           +----GnomeApp</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN9010"
></A
><H2
>Description</H2
><P
>Toplevel GNOME applications would normally use one
<SPAN
CLASS="TYPE"
>GnomeApp</SPAN
> widget as their toplevel window.  You can create
as many <SPAN
CLASS="TYPE"
>GnomeApp</SPAN
> widgets as you want, for example, some
people use one GnomeApp per document their application loads.</P
><P
>Once you have created one instance of this widget, you would add
your main application view information to this window by using
<A
HREF="gnomeapp.html#GNOME-APP-SET-CONTENTS"
>gnome_app_set_contents</A
>() routine.</P
><P
> The <SPAN
CLASS="TYPE"
>GnomeApp</SPAN
> has support for including a menubar,
one or more toolbars and a statusbar for your application. It also
takes care of intalling the accelerators for you when used in
conjuction with the gnome-app-helper routines.  The toolbars are
inserted into <SPAN
CLASS="TYPE"
>GnomeDock</SPAN
> widgets.</P
><P
>The <TT
CLASS="FILENAME"
>gnome-app-helper</TT
> module provides
various helper routines to simplify the configuration of your menus
and toolbars, but you can create those yourself and use the
<A
HREF="gnomeapp.html#GNOME-APP-SET-MENUS"
>gnome_app_set_menus</A
>(), <A
HREF="gnomeapp.html#GNOME-APP-ADD-TOOLBAR"
>gnome_app_add_toolbar</A
>(),
<A
HREF="gnomeapp.html#GNOME-APP-SET-TOOLBAR"
>gnome_app_set_toolbar</A
>(), <A
HREF="gnomeapp.html#GNOME-APP-ADD-DOCK-ITEM"
>gnome_app_add_dock_item</A
>(),
and <A
HREF="gnomeapp.html#GNOME-APP-ADD-DOCKED"
>gnome_app_add_docked</A
>().</P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN9027"
></A
><H2
>Details</H2
><DIV
CLASS="REFSECT2"
><A
NAME="AEN9029"
></A
><H3
><A
NAME="GNOMEAPP-STRUCT"
></A
>struct GnomeApp</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>struct GnomeApp;</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN9034"
></A
><H3
><A
NAME="GNOME-APP-NEW"
></A
>gnome_app_new ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><GTKDOCLINK
HREF="GTKWIDGET"
>GtkWidget</GTKDOCLINK
>*  gnome_app_new                   (<GTKDOCLINK
HREF="GCHAR"
>gchar</GTKDOCLINK
> *appname,
                                             char *title);</PRE
></TD
></TR
></TABLE
><P
>Create a new (empty) application window.  You must specify the
application's name (used internally as an identifier).
<TT
CLASS="PARAMETER"
><I
>title</I
></TT
> can be left as NULL, in which case the window's title will
not be set.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>appname</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Name of program, using in file names and paths.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>title</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Window title for application.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to new GNOME app object.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN9060"
></A
><H3
><A
NAME="GNOME-APP-CONSTRUCT"
></A
>gnome_app_construct ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_app_construct             (<A
HREF="gnomeapp.html"
>GnomeApp</A
> *app,
                                             <GTKDOCLINK
HREF="GCHAR"
>gchar</GTKDOCLINK
> *appname,
                                             char *title);</PRE
></TD
></TR
></TABLE
><P
>Constructor for language bindings; you don't normally need this.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>app</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to newly-created GNOME app object.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>appname</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Name of program, using in file names and paths.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>title</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Window title for application.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN9085"
></A
><H3
><A
NAME="GNOME-APP-MENUBAR-NAME"
></A
>GNOME_APP_MENUBAR_NAME</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_APP_MENUBAR_NAME "Menubar"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN9090"
></A
><H3
><A
NAME="GNOME-APP-TOOLBAR-NAME"
></A
>GNOME_APP_TOOLBAR_NAME</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_APP_TOOLBAR_NAME "Toolbar"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN9095"
></A
><H3
><A
NAME="GNOME-APP-SET-MENUS"
></A
>gnome_app_set_menus ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_app_set_menus             (<A
HREF="gnomeapp.html"
>GnomeApp</A
> *app,
                                             <GTKDOCLINK
HREF="GTKMENUBAR"
>GtkMenuBar</GTKDOCLINK
> *menubar);</PRE
></TD
></TR
></TABLE
><P
>Sets the menu bar of the application window.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>app</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GNOME app object.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>menubar</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Menu bar widget for main app window.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN9116"
></A
><H3
><A
NAME="GNOME-APP-SET-TOOLBAR"
></A
>gnome_app_set_toolbar ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_app_set_toolbar           (<A
HREF="gnomeapp.html"
>GnomeApp</A
> *app,
                                             <GTKDOCLINK
HREF="GTKTOOLBAR"
>GtkToolbar</GTKDOCLINK
> *toolbar);</PRE
></TD
></TR
></TABLE
><P
>Sets the main toolbar of the application window.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>app</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GNOME app object.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>toolbar</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Toolbar widget for main app window.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN9137"
></A
><H3
><A
NAME="GNOME-APP-SET-STATUSBAR"
></A
>gnome_app_set_statusbar ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_app_set_statusbar         (<A
HREF="gnomeapp.html"
>GnomeApp</A
> *app,
                                             <GTKDOCLINK
HREF="GTKWIDGET"
>GtkWidget</GTKDOCLINK
> *statusbar);</PRE
></TD
></TR
></TABLE
><P
>Sets the status bar of the application window.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>app</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GNOME app object</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>statusbar</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Statusbar widget for main app window</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN9158"
></A
><H3
><A
NAME="GNOME-APP-SET-CONTENTS"
></A
>gnome_app_set_contents ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_app_set_contents          (<A
HREF="gnomeapp.html"
>GnomeApp</A
> *app,
                                             <GTKDOCLINK
HREF="GTKWIDGET"
>GtkWidget</GTKDOCLINK
> *contents);</PRE
></TD
></TR
></TABLE
><P
>Sets the content area of the GNOME app's main window.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>app</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GNOME app object.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>contents</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Widget to be application content area.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN9179"
></A
><H3
><A
NAME="GNOME-APP-ADD-TOOLBAR"
></A
>gnome_app_add_toolbar ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_app_add_toolbar           (<A
HREF="gnomeapp.html"
>GnomeApp</A
> *app,
                                             <GTKDOCLINK
HREF="GTKTOOLBAR"
>GtkToolbar</GTKDOCLINK
> *toolbar,
                                             const <GTKDOCLINK
HREF="GCHAR"
>gchar</GTKDOCLINK
> *name,
                                             <A
HREF="gnomedockitem.html#GNOMEDOCKITEMBEHAVIOR"
>GnomeDockItemBehavior</A
> behavior,
                                             <A
HREF="gnomedock.html#GNOMEDOCKPLACEMENT"
>GnomeDockPlacement</A
> placement,
                                             <GTKDOCLINK
HREF="GINT"
>gint</GTKDOCLINK
> band_num,
                                             <GTKDOCLINK
HREF="GINT"
>gint</GTKDOCLINK
> band_position,
                                             <GTKDOCLINK
HREF="GINT"
>gint</GTKDOCLINK
> offset);</PRE
></TD
></TR
></TABLE
><P
>Create a new &amp;GnomeDockItem widget containing <TT
CLASS="PARAMETER"
><I
>toolbar</I
></TT
>, and add it
to <TT
CLASS="PARAMETER"
><I
>app</I
></TT
>'s dock with the specified layout information.  Notice that,
if automatic layout configuration is enabled, the layout is
overridden by the saved configuration, if any.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>app</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A &amp;GnomeApp widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>toolbar</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Toolbar to be added to <TT
CLASS="PARAMETER"
><I
>app</I
></TT
>'s dock</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>name</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Name for the dock item that will contain <TT
CLASS="PARAMETER"
><I
>toolbar</I
></TT
></TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>behavior</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Behavior for the new dock item</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>placement</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Placement for the new dock item</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>band_num</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Number of the band where the dock item should be placed</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>band_position</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Position of the new dock item in band <TT
CLASS="PARAMETER"
><I
>band_num</I
></TT
></TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>offset</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Offset from the previous dock item in the band; if there is
no previous item, offset from the beginning of the band.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN9235"
></A
><H3
><A
NAME="GNOME-APP-ADD-DOCKED"
></A
>gnome_app_add_docked ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_app_add_docked            (<A
HREF="gnomeapp.html"
>GnomeApp</A
> *app,
                                             <GTKDOCLINK
HREF="GTKWIDGET"
>GtkWidget</GTKDOCLINK
> *widget,
                                             const <GTKDOCLINK
HREF="GCHAR"
>gchar</GTKDOCLINK
> *name,
                                             <A
HREF="gnomedockitem.html#GNOMEDOCKITEMBEHAVIOR"
>GnomeDockItemBehavior</A
> behavior,
                                             <A
HREF="gnomedock.html#GNOMEDOCKPLACEMENT"
>GnomeDockPlacement</A
> placement,
                                             <GTKDOCLINK
HREF="GINT"
>gint</GTKDOCLINK
> band_num,
                                             <GTKDOCLINK
HREF="GINT"
>gint</GTKDOCLINK
> band_position,
                                             <GTKDOCLINK
HREF="GINT"
>gint</GTKDOCLINK
> offset);</PRE
></TD
></TR
></TABLE
><P
>Add <TT
CLASS="PARAMETER"
><I
>widget</I
></TT
> as a dock item according to the specified layout
information.  Notice that, if automatic layout configuration is
enabled, the layout is overridden by the saved configuration, if
any.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>app</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A &amp;GnomeApp widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>widget</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Widget to be added to the &amp;GnomeApp</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>name</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Name for the new dock item</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>behavior</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Behavior for the new dock item</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>placement</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Placement for the new dock item</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>band_num</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Number of the band where the dock item should be placed</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>band_position</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Position of the new dock item in band <TT
CLASS="PARAMETER"
><I
>band_num</I
></TT
></TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>offset</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Offset from the previous dock item in the band; if there is
no previous item, offset from the beginning of the band.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN9288"
></A
><H3
><A
NAME="GNOME-APP-ADD-DOCK-ITEM"
></A
>gnome_app_add_dock_item ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_app_add_dock_item         (<A
HREF="gnomeapp.html"
>GnomeApp</A
> *app,
                                             <A
HREF="gnomedockitem.html"
>GnomeDockItem</A
> *item,
                                             <A
HREF="gnomedock.html#GNOMEDOCKPLACEMENT"
>GnomeDockPlacement</A
> placement,
                                             <GTKDOCLINK
HREF="GINT"
>gint</GTKDOCLINK
> band_num,
                                             <GTKDOCLINK
HREF="GINT"
>gint</GTKDOCLINK
> band_position,
                                             <GTKDOCLINK
HREF="GINT"
>gint</GTKDOCLINK
> offset);</PRE
></TD
></TR
></TABLE
><P
>Add <TT
CLASS="PARAMETER"
><I
>item</I
></TT
> according to the specified layout information.  Notice
that, if automatic layout configuration is enabled, the layout is
overridden by the saved configuration, if any.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>app</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A &amp;GnomeApp widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>item</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Dock item to be added to <TT
CLASS="PARAMETER"
><I
>app</I
></TT
>'s dock.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>placement</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Placement for the dock item</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>band_num</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Number of the band where the dock item should be placed</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>band_position</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Position of the dock item in band <TT
CLASS="PARAMETER"
><I
>band_num</I
></TT
></TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>offset</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Offset from the previous dock item in the band; if there is
no previous item, offset from the beginning of the band.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN9332"
></A
><H3
><A
NAME="GNOME-APP-ENABLE-LAYOUT-CONFIG"
></A
>gnome_app_enable_layout_config ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_app_enable_layout_config  (<A
HREF="gnomeapp.html"
>GnomeApp</A
> *app,
                                             <GTKDOCLINK
HREF="GBOOLEAN"
>gboolean</GTKDOCLINK
> enable);</PRE
></TD
></TR
></TABLE
><P
>Specify whether <TT
CLASS="PARAMETER"
><I
>app</I
></TT
> should automatically save the dock's
layout configuration via gnome-config whenever it changes or not.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>app</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A &amp;GnomeApp widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>enable</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Boolean specifying whether automatic configuration saving
is enabled</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN9354"
></A
><H3
><A
NAME="GNOME-APP-GET-DOCK"
></A
>gnome_app_get_dock ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF="gnomedock.html"
>GnomeDock</A
>*  gnome_app_get_dock              (<A
HREF="gnomeapp.html"
>GnomeApp</A
> *app);</PRE
></TD
></TR
></TABLE
><P
>Retrieves the &amp;GnomeDock widget contained in the &amp;GnomeApp.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>app</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A &amp;GnomeApp widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> The &amp;GnomeDock widget.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN9375"
></A
><H3
><A
NAME="GNOME-APP-GET-DOCK-ITEM-BY-NAME"
></A
>gnome_app_get_dock_item_by_name ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF="gnomedockitem.html"
>GnomeDockItem</A
>* gnome_app_get_dock_item_by_name
                                            (<A
HREF="gnomeapp.html"
>GnomeApp</A
> *app,
                                             const <GTKDOCLINK
HREF="GCHAR"
>gchar</GTKDOCLINK
> *name);</PRE
></TD
></TR
></TABLE
><P
>Retrieve the dock item whose name matches <TT
CLASS="PARAMETER"
><I
>name</I
></TT
>.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>app</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A &amp;GnomeApp widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>name</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Name of the dock item to retrieve</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> The retrieved dock item.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
></DIV
><DIV
CLASS="NAVFOOTER"
><BR
CLEAR="all"><BR><TABLE
WIDTH="100%"
BORDER="0"
BGCOLOR="#000000"
CELLPADDING="1"
CELLSPACING="0"
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomeanimator.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>&#60;&#60;&#60; Previous Page</B
></FONT
></A
></TD
><TD
WIDTH="25%"
BGCOLOR="#0000C0"
ALIGN="center"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
><A
HREF="book1.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Home</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#00C000"
ALIGN="center"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
><A
HREF="gnome-objects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomeappbar.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Next Page &#62;&#62;&#62;</B
></FONT
></A
></TD
></TR
><TR
><TD
COLSPAN="2"
ALIGN="left"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>GnomeAnimator</B
></FONT
></TD
><TD
COLSPAN="2"
ALIGN="right"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>GnomeAppBar</B
></FONT
></TD
></TR
></TABLE
></DIV
></BODY
></HTML
>