<HTML
><HEAD
><TITLE
>GnomeDock</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="GnomeDockItem"
HREF="gnomedockitem.html"><LINK
REL="NEXT"
TITLE="GnomeDruid"
HREF="gnomedruid.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="gnomedockitem.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="gnomedruid.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Next Page &#62;&#62;&#62;</B
></FONT
></A
></TD
></TR
></TABLE
></DIV
><H1
><A
NAME="GNOMEDOCK"
>GnomeDock</A
></H1
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN15409"
></A
><H2
>Name</H2
>GnomeDock&nbsp;--&nbsp;A widget supporting movable and detachable widgets.</DIV
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN15412"
></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="gnomedock.html#GNOMEDOCK-STRUCT"
>GnomeDock</A
>;
enum        <A
HREF="gnomedock.html#GNOMEDOCKPLACEMENT"
>GnomeDockPlacement</A
>;
<GTKDOCLINK
HREF="GTKWIDGET"
>GtkWidget</GTKDOCLINK
>*  <A
HREF="gnomedock.html#GNOME-DOCK-NEW"
>gnome_dock_new</A
>                  (void);
void        <A
HREF="gnomedock.html#GNOME-DOCK-ALLOW-FLOATING-ITEMS"
>gnome_dock_allow_floating_items</A
> (<A
HREF="gnomedock.html"
>GnomeDock</A
> *dock,
                                             <GTKDOCLINK
HREF="GBOOLEAN"
>gboolean</GTKDOCLINK
> enable);
void        <A
HREF="gnomedock.html#GNOME-DOCK-ADD-ITEM"
>gnome_dock_add_item</A
>             (<A
HREF="gnomedock.html"
>GnomeDock</A
> *dock,
                                             <A
HREF="gnomedockitem.html"
>GnomeDockItem</A
> *item,
                                             <A
HREF="gnomedock.html#GNOMEDOCKPLACEMENT"
>GnomeDockPlacement</A
> placement,
                                             <GTKDOCLINK
HREF="GUINT"
>guint</GTKDOCLINK
> band_num,
                                             <GTKDOCLINK
HREF="GINT"
>gint</GTKDOCLINK
> position,
                                             <GTKDOCLINK
HREF="GUINT"
>guint</GTKDOCLINK
> offset,
                                             <GTKDOCLINK
HREF="GBOOLEAN"
>gboolean</GTKDOCLINK
> in_new_band);
void        <A
HREF="gnomedock.html#GNOME-DOCK-ADD-FLOATING-ITEM"
>gnome_dock_add_floating_item</A
>    (<A
HREF="gnomedock.html"
>GnomeDock</A
> *dock,
                                             <A
HREF="gnomedockitem.html"
>GnomeDockItem</A
> *widget,
                                             <GTKDOCLINK
HREF="GINT"
>gint</GTKDOCLINK
> x,
                                             <GTKDOCLINK
HREF="GINT"
>gint</GTKDOCLINK
> y,
                                             <GTKDOCLINK
HREF="GTKORIENTATION"
>GtkOrientation</GTKDOCLINK
> orientation);
void        <A
HREF="gnomedock.html#GNOME-DOCK-SET-CLIENT-AREA"
>gnome_dock_set_client_area</A
>      (<A
HREF="gnomedock.html"
>GnomeDock</A
> *dock,
                                             <GTKDOCLINK
HREF="GTKWIDGET"
>GtkWidget</GTKDOCLINK
> *widget);
<GTKDOCLINK
HREF="GTKWIDGET"
>GtkWidget</GTKDOCLINK
>*  <A
HREF="gnomedock.html#GNOME-DOCK-GET-CLIENT-AREA"
>gnome_dock_get_client_area</A
>      (<A
HREF="gnomedock.html"
>GnomeDock</A
> *dock);
<A
HREF="gnomedockitem.html"
>GnomeDockItem</A
>* <A
HREF="gnomedock.html#GNOME-DOCK-GET-ITEM-BY-NAME"
>gnome_dock_get_item_by_name</A
>  (<A
HREF="gnomedock.html"
>GnomeDock</A
> *dock,
                                             const <GTKDOCLINK
HREF="GCHAR"
>gchar</GTKDOCLINK
> *name,
                                             <A
HREF="gnomedock.html#GNOMEDOCKPLACEMENT"
>GnomeDockPlacement</A
> *placement_return,
                                             <GTKDOCLINK
HREF="GUINT"
>guint</GTKDOCLINK
> *num_band_return,
                                             <GTKDOCLINK
HREF="GUINT"
>guint</GTKDOCLINK
> *band_position_return,
                                             <GTKDOCLINK
HREF="GUINT"
>guint</GTKDOCLINK
> *offset_return);
<A
HREF="gnomedocklayout.html"
>GnomeDockLayout</A
>* <A
HREF="gnomedock.html#GNOME-DOCK-GET-LAYOUT"
>gnome_dock_get_layout</A
>      (<A
HREF="gnomedock.html"
>GnomeDock</A
> *dock);
<GTKDOCLINK
HREF="GBOOLEAN"
>gboolean</GTKDOCLINK
>    <A
HREF="gnomedock.html#GNOME-DOCK-ADD-FROM-LAYOUT"
>gnome_dock_add_from_layout</A
>      (<A
HREF="gnomedock.html"
>GnomeDock</A
> *dock,
                                             <A
HREF="gnomedocklayout.html"
>GnomeDockLayout</A
> *layout);&#13;</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN15457"
></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
>
               +----GnomeDock</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN15463"
></A
><H2
>Description</H2
><P
><SPAN
CLASS="TYPE"
>GnomeDock</SPAN
> is a container widget designed to let users
move around widgets such as toolbars, menubars and so on.</P
><P
>Every <SPAN
CLASS="TYPE"
>GnomeDock</SPAN
> contains a widget called the "client
area".  On the four sides of the client area, there are four "dock
areas", which can contain an arbitrary number of dockable widgets.
All the dockable widgets should be <SPAN
CLASS="TYPE"
>GnomeDockItem</SPAN
>
widgets; the <SPAN
CLASS="TYPE"
>GnomeDockItem</SPAN
> widget can in turn contain
any kind of widget, and implements the dragging functionality: every
<SPAN
CLASS="TYPE"
>GnomeDockItem</SPAN
> has a handle that users can use to move
them within the dock, or even move them outside it, so that they
become "floating items".</P
><P
>Every "dock area" is implemented by means of zero or more "dock
bands": a dock band is a horizontal or vertical stripe containing one
or more dock items, and is implemented by the
<SPAN
CLASS="TYPE"
>GnomeDockBand</SPAN
> widget.  Items are ordered from top to
bottom in vertical bands, and from left to right in horizontal bands.
Every dock item in a band is given an offset value that defines the
distance, in pixels, from the previous item in the same band; if the
item is first in the band, the offset defines the distance from the
start of the band.</P
><P
>As a consequence, the position of an item in the dock can be specified
by means of the following values: a "placement" specifying what area
is being used (top, bottom, left, right), a "band number" specifying
the number of the band within the specified area, a "position" within
the band and a "offset" from the previous item in the same band.</P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN15475"
></A
><H2
>Details</H2
><DIV
CLASS="REFSECT2"
><A
NAME="AEN15477"
></A
><H3
><A
NAME="GNOMEDOCK-STRUCT"
></A
>struct GnomeDock</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>struct GnomeDock;</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN15482"
></A
><H3
><A
NAME="GNOMEDOCKPLACEMENT"
></A
>enum GnomeDockPlacement</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>typedef enum
{
  GNOME_DOCK_TOP,
  GNOME_DOCK_RIGHT,
  GNOME_DOCK_BOTTOM,
  GNOME_DOCK_LEFT,
  GNOME_DOCK_FLOATING
} GnomeDockPlacement;</PRE
></TD
></TR
></TABLE
><P
>This enumeration is used to specify the position of a dock item in the
dock widget.</P
><P
><P
></P
><UL
><LI
><P
>GNOME_DOCK_TOP - The horizontal area at the top of the dock widget </P
></LI
><LI
><P
>GNOME_DOCK_RIGHT - The vertical area on the right side of the dock widget </P
></LI
><LI
><P
>GNOME_DOCK_BOTTOM - The horizontal area at the bottom of the dock widget </P
></LI
><LI
><P
>GNOME_DOCK_RIGHT - The vertical area on the right side of the dock widget </P
></LI
><LI
><P
>GNOME_DOCK_FLOATING - Used for floating (detached) items</P
></LI
></UL
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN15499"
></A
><H3
><A
NAME="GNOME-DOCK-NEW"
></A
>gnome_dock_new ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><GTKDOCLINK
HREF="GTKWIDGET"
>GtkWidget</GTKDOCLINK
>*  gnome_dock_new                  (void);</PRE
></TD
></TR
></TABLE
><P
>Creates a new <A
HREF="gnomedock.html"
>GnomeDock</A
> widget.</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"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> The new widget.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN15516"
></A
><H3
><A
NAME="GNOME-DOCK-ALLOW-FLOATING-ITEMS"
></A
>gnome_dock_allow_floating_items ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_dock_allow_floating_items (<A
HREF="gnomedock.html"
>GnomeDock</A
> *dock,
                                             <GTKDOCLINK
HREF="GBOOLEAN"
>gboolean</GTKDOCLINK
> enable);</PRE
></TD
></TR
></TABLE
><P
>Enable or disable floating items on <TT
CLASS="PARAMETER"
><I
>dock</I
></TT
>, according
to <TT
CLASS="PARAMETER"
><I
>enable</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
>dock</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A pointer to a <A
HREF="gnomedock.html"
>GnomeDock</A
> 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"
> Specifies whether floating items are allowed in this dock</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN15540"
></A
><H3
><A
NAME="GNOME-DOCK-ADD-ITEM"
></A
>gnome_dock_add_item ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_dock_add_item             (<A
HREF="gnomedock.html"
>GnomeDock</A
> *dock,
                                             <A
HREF="gnomedockitem.html"
>GnomeDockItem</A
> *item,
                                             <A
HREF="gnomedock.html#GNOMEDOCKPLACEMENT"
>GnomeDockPlacement</A
> placement,
                                             <GTKDOCLINK
HREF="GUINT"
>guint</GTKDOCLINK
> band_num,
                                             <GTKDOCLINK
HREF="GINT"
>gint</GTKDOCLINK
> position,
                                             <GTKDOCLINK
HREF="GUINT"
>guint</GTKDOCLINK
> offset,
                                             <GTKDOCLINK
HREF="GBOOLEAN"
>gboolean</GTKDOCLINK
> in_new_band);</PRE
></TD
></TR
></TABLE
><P
>Add <TT
CLASS="PARAMETER"
><I
>item</I
></TT
> to <TT
CLASS="PARAMETER"
><I
>dock</I
></TT
>.  <TT
CLASS="PARAMETER"
><I
>placement</I
></TT
> can be either
<TT
CLASS="LITERAL"
>GNOME_DOCK_TOP</TT
>, <TT
CLASS="LITERAL"
>GNOME_DOCK_RIGHT</TT
>, <TT
CLASS="LITERAL"
>GNOME_DOCK_BOTTOM</TT
> or
<TT
CLASS="LITERAL"
>GNOME_DOCK_LEFT</TT
>, and specifies what area of the dock should
contain the item.  If <TT
CLASS="PARAMETER"
><I
>in_new_band</I
></TT
> is <TT
CLASS="LITERAL"
>TRUE</TT
>, a new dock band is
created at the position specified by <TT
CLASS="PARAMETER"
><I
>band_num</I
></TT
>; otherwise, the item
is added to the <TT
CLASS="PARAMETER"
><I
>band_num</I
></TT
>'th band.</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
>dock</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A pointer to a <A
HREF="gnomedock.html"
>GnomeDock</A
> 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"
> The item to add</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 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 the new item must be added to</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>position</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Position of the item in the specified band</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 (in pixels) from the previous item in the same band</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>in_new_band</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Specifies whether a new band must be created for this item</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN15598"
></A
><H3
><A
NAME="GNOME-DOCK-ADD-FLOATING-ITEM"
></A
>gnome_dock_add_floating_item ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_dock_add_floating_item    (<A
HREF="gnomedock.html"
>GnomeDock</A
> *dock,
                                             <A
HREF="gnomedockitem.html"
>GnomeDockItem</A
> *widget,
                                             <GTKDOCLINK
HREF="GINT"
>gint</GTKDOCLINK
> x,
                                             <GTKDOCLINK
HREF="GINT"
>gint</GTKDOCLINK
> y,
                                             <GTKDOCLINK
HREF="GTKORIENTATION"
>GtkOrientation</GTKDOCLINK
> orientation);</PRE
></TD
></TR
></TABLE
><P
>Add <TT
CLASS="PARAMETER"
><I
>item</I
></TT
> to <TT
CLASS="PARAMETER"
><I
>dock</I
></TT
> and make it floating at the
specified (<TT
CLASS="PARAMETER"
><I
>x</I
></TT
>, <TT
CLASS="PARAMETER"
><I
>y</I
></TT
>) coordinates (relative to the root window of the
screen).</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
>dock</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A <A
HREF="gnomedock.html"
>GnomeDock</A
> 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"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>x</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> X-coordinate for the floating item</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>y</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Y-coordinate for the floating item</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>orientation</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Orientation for the new item.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN15639"
></A
><H3
><A
NAME="GNOME-DOCK-SET-CLIENT-AREA"
></A
>gnome_dock_set_client_area ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_dock_set_client_area      (<A
HREF="gnomedock.html"
>GnomeDock</A
> *dock,
                                             <GTKDOCLINK
HREF="GTKWIDGET"
>GtkWidget</GTKDOCLINK
> *widget);</PRE
></TD
></TR
></TABLE
><P
>Specify a widget for the dock's client area.</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
>dock</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A <A
HREF="gnomedock.html"
>GnomeDock</A
> 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"
> The widget to be used for the client area.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN15661"
></A
><H3
><A
NAME="GNOME-DOCK-GET-CLIENT-AREA"
></A
>gnome_dock_get_client_area ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><GTKDOCLINK
HREF="GTKWIDGET"
>GtkWidget</GTKDOCLINK
>*  gnome_dock_get_client_area      (<A
HREF="gnomedock.html"
>GnomeDock</A
> *dock);</PRE
></TD
></TR
></TABLE
><P
>Retrieve the widget being used as the client area in
<TT
CLASS="PARAMETER"
><I
>dock</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
>dock</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A <A
HREF="gnomedock.html"
>GnomeDock</A
> 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 client area widget.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN15684"
></A
><H3
><A
NAME="GNOME-DOCK-GET-ITEM-BY-NAME"
></A
>gnome_dock_get_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_dock_get_item_by_name  (<A
HREF="gnomedock.html"
>GnomeDock</A
> *dock,
                                             const <GTKDOCLINK
HREF="GCHAR"
>gchar</GTKDOCLINK
> *name,
                                             <A
HREF="gnomedock.html#GNOMEDOCKPLACEMENT"
>GnomeDockPlacement</A
> *placement_return,
                                             <GTKDOCLINK
HREF="GUINT"
>guint</GTKDOCLINK
> *num_band_return,
                                             <GTKDOCLINK
HREF="GUINT"
>guint</GTKDOCLINK
> *band_position_return,
                                             <GTKDOCLINK
HREF="GUINT"
>guint</GTKDOCLINK
> *offset_return);</PRE
></TD
></TR
></TABLE
><P
>Retrieve the dock item named <TT
CLASS="PARAMETER"
><I
>name</I
></TT
>; information about
its position in the dock is returned via <TT
CLASS="PARAMETER"
><I
>placement_return</I
></TT
>,
<TT
CLASS="PARAMETER"
><I
>num_band_return</I
></TT
>, <TT
CLASS="PARAMETER"
><I
>band_position_return</I
></TT
> and <TT
CLASS="PARAMETER"
><I
>offset_return</I
></TT
>.  If
the placement is <TT
CLASS="LITERAL"
>GNOME_DOCK_FLOATING</TT
> *<TT
CLASS="PARAMETER"
><I
>num_band_return</I
></TT
>,
*<TT
CLASS="PARAMETER"
><I
>band_position_return</I
></TT
> and *<TT
CLASS="PARAMETER"
><I
>offset_return</I
></TT
> are not 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
>dock</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A <A
HREF="gnomedock.html"
>GnomeDock</A
> 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"
> The name of the dock item to retrieve</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>placement_return</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A pointer to a variable holding the item's placement</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>num_band_return</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A pointer to a variable holding the band number</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>band_position_return</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A pointer to a variable holding the position
of the item within the band</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>offset_return</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A pointer to a variable holding the offset of the item
from the previous item in the same band</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> The named <A
HREF="gnomedockitem.html"
>GnomeDockItem</A
> widget, or <TT
CLASS="LITERAL"
>NULL</TT
> if no item with
such name exists.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN15742"
></A
><H3
><A
NAME="GNOME-DOCK-GET-LAYOUT"
></A
>gnome_dock_get_layout ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF="gnomedocklayout.html"
>GnomeDockLayout</A
>* gnome_dock_get_layout      (<A
HREF="gnomedock.html"
>GnomeDock</A
> *dock);</PRE
></TD
></TR
></TABLE
><P
>Retrieve the layout of <TT
CLASS="PARAMETER"
><I
>dock</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
>dock</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A <A
HREF="gnomedock.html"
>GnomeDock</A
> widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> <TT
CLASS="PARAMETER"
><I
>dock</I
></TT
>'s layout as a <A
HREF="gnomedocklayout.html"
>GnomeDockLayout</A
> object.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN15767"
></A
><H3
><A
NAME="GNOME-DOCK-ADD-FROM-LAYOUT"
></A
>gnome_dock_add_from_layout ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><GTKDOCLINK
HREF="GBOOLEAN"
>gboolean</GTKDOCLINK
>    gnome_dock_add_from_layout      (<A
HREF="gnomedock.html"
>GnomeDock</A
> *dock,
                                             <A
HREF="gnomedocklayout.html"
>GnomeDockLayout</A
> *layout);</PRE
></TD
></TR
></TABLE
><P
>Add all the items in <TT
CLASS="PARAMETER"
><I
>layout</I
></TT
> to the specified <TT
CLASS="PARAMETER"
><I
>dock</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
>dock</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> The <A
HREF="gnomedock.html"
>GnomeDock</A
> widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>layout</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A <A
HREF="gnomedocklayout.html"
>GnomeDockLayout</A
> widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> <TT
CLASS="LITERAL"
>TRUE</TT
> if the operation succeeds, <TT
CLASS="LITERAL"
>FALSE</TT
> if it fails.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN15799"
></A
><H2
>See Also</H2
><P
><A
HREF="gnomedockitem.html"
>GnomeDockItem</A
>
<A
HREF="gnomedockband.html"
>GnomeDockBand</A
>
<A
HREF="gnomedocklayout.html"
>GnomeDockLayout</A
></P
></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="gnomedockitem.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="gnomedruid.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
>GnomeDockItem</B
></FONT
></TD
><TD
COLSPAN="2"
ALIGN="right"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>GnomeDruid</B
></FONT
></TD
></TR
></TABLE
></DIV
></BODY
></HTML
>