<HTML
><HEAD
><TITLE
>GnomeApp</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.74b"><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
CLASS="REFENTRY"
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
><<< 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 >>></B
></FONT
></A
></TD
></TR
></TABLE
></DIV
><H1
><A
NAME="GNOMEAPP"
>GnomeApp</A
></H1
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN8944"
></A
><H2
>Name</H2
>GnomeApp -- The toplevel GNOME container</DIV
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN8947"
></A
><H2
>Synopsis</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
> #include <gnome.h>
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-CAPS"
>GNOME_APP_MENUBAR_NAME</A
>
#define <A
HREF="gnomeapp.html#GNOME-APP-TOOLBAR-NAME-CAPS"
>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); </PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN9006"
></A
><H2
>Object Hierarchy</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
> <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="AEN9014"
></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="AEN9031"
></A
><H2
>Details</H2
><DIV
CLASS="REFSECT2"
><A
NAME="AEN9033"
></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="AEN9038"
></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"
><A
NAME="AEN9047"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>appname</I
></TT
> :</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
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Window title for application.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
>Returns</I
></SPAN
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to new GNOME app object.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN9064"
></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"
><A
NAME="AEN9072"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>app</I
></TT
> :</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
> :</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
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Window title for application.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN9089"
></A
><H3
><A
NAME="GNOME-APP-MENUBAR-NAME-CAPS"
></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="AEN9094"
></A
><H3
><A
NAME="GNOME-APP-TOOLBAR-NAME-CAPS"
></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="AEN9099"
></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"
><A
NAME="AEN9107"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>app</I
></TT
> :</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
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Menu bar widget for main app window.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN9120"
></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"
><A
NAME="AEN9128"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>app</I
></TT
> :</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
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Toolbar widget for main app window.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN9141"
></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"
><A
NAME="AEN9149"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>app</I
></TT
> :</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
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Statusbar widget for main app window</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN9162"
></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"
><A
NAME="AEN9170"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>app</I
></TT
> :</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
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Widget to be application content area.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN9183"
></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 &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"
><A
NAME="AEN9199"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>app</I
></TT
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A &GnomeApp widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>toolbar</I
></TT
> :</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
> :</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
> :</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
> :</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
> :</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
> :</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
> :</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
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN9239"
></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"
><A
NAME="AEN9254"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>app</I
></TT
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A &GnomeApp widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>widget</I
></TT
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Widget to be added to the &GnomeApp</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>name</I
></TT
> :</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
> :</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
> :</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
> :</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
> :</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
> :</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
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN9292"
></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"
><A
NAME="AEN9305"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>app</I
></TT
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A &GnomeApp widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>item</I
></TT
> :</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
> :</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
> :</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
> :</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
> :</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
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN9336"
></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"
><A
NAME="AEN9345"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>app</I
></TT
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A &GnomeApp widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>enable</I
></TT
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Boolean specifying whether automatic configuration saving
is enabled</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN9358"
></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 &GnomeDock widget contained in the &GnomeApp.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN9366"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>app</I
></TT
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A &GnomeApp widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
>Returns</I
></SPAN
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> The &GnomeDock widget.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN9379"
></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"
><A
NAME="AEN9389"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>app</I
></TT
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A &GnomeApp widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>name</I
></TT
> :</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"
><SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
>Returns</I
></SPAN
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> The retrieved dock item.</TD
></TR
></TBODY
></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
><<< 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 >>></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
>
