<HTML ><HEAD ><TITLE >GnomeDockBand</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="GnomeDialog" HREF="gnomedialog.html"><LINK REL="NEXT" TITLE="GnomeDockItem" HREF="gnomedockitem.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="gnomedialog.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="gnomedockitem.html" ><FONT COLOR="#FFFFFF" SIZE="3" ><B >Next Page >>></B ></FONT ></A ></TD ></TR ></TABLE ></DIV ><H1 ><A NAME="GNOMEDOCKBAND" >GnomeDockBand</A ></H1 ><DIV CLASS="REFNAMEDIV" ><A NAME="AEN14471" ></A ><H2 >Name</H2 >GnomeDockBand -- A widget implementing dock bands.</DIV ><DIV CLASS="REFSYNOPSISDIV" ><A NAME="AEN14474" ></A ><H2 >Synopsis</H2 ><TABLE BORDER="0" BGCOLOR="#D6E8FF" WIDTH="100%" CELLPADDING="6" ><TR ><TD ><PRE CLASS="SYNOPSIS" > #include <gnome.h> struct <A HREF="gnomedockband.html#GNOMEDOCKBAND-STRUCT" >GnomeDockBand</A >; struct <A HREF="gnomedockband.html#GNOMEDOCKBANDCHILD" >GnomeDockBandChild</A >; <GTKDOCLINK HREF="GTKWIDGET" >GtkWidget</GTKDOCLINK >* <A HREF="gnomedockband.html#GNOME-DOCK-BAND-NEW" >gnome_dock_band_new</A > (void); void <A HREF="gnomedockband.html#GNOME-DOCK-BAND-SET-ORIENTATION" >gnome_dock_band_set_orientation</A > (<A HREF="gnomedockband.html" >GnomeDockBand</A > *band, <GTKDOCLINK HREF="GTKORIENTATION" >GtkOrientation</GTKDOCLINK > orientation); <GTKDOCLINK HREF="GTKORIENTATION" >GtkOrientation</GTKDOCLINK > <A HREF="gnomedockband.html#GNOME-DOCK-BAND-GET-ORIENTATION" >gnome_dock_band_get_orientation</A > (<A HREF="gnomedockband.html" >GnomeDockBand</A > *band); <GTKDOCLINK HREF="GBOOLEAN" >gboolean</GTKDOCLINK > <A HREF="gnomedockband.html#GNOME-DOCK-BAND-INSERT" >gnome_dock_band_insert</A > (<A HREF="gnomedockband.html" >GnomeDockBand</A > *band, <GTKDOCLINK HREF="GTKWIDGET" >GtkWidget</GTKDOCLINK > *child, <GTKDOCLINK HREF="GUINT" >guint</GTKDOCLINK > offset, <GTKDOCLINK HREF="GINT" >gint</GTKDOCLINK > position); <GTKDOCLINK HREF="GBOOLEAN" >gboolean</GTKDOCLINK > <A HREF="gnomedockband.html#GNOME-DOCK-BAND-PREPEND" >gnome_dock_band_prepend</A > (<A HREF="gnomedockband.html" >GnomeDockBand</A > *band, <GTKDOCLINK HREF="GTKWIDGET" >GtkWidget</GTKDOCLINK > *child, <GTKDOCLINK HREF="GUINT" >guint</GTKDOCLINK > offset); <GTKDOCLINK HREF="GBOOLEAN" >gboolean</GTKDOCLINK > <A HREF="gnomedockband.html#GNOME-DOCK-BAND-APPEND" >gnome_dock_band_append</A > (<A HREF="gnomedockband.html" >GnomeDockBand</A > *band, <GTKDOCLINK HREF="GTKWIDGET" >GtkWidget</GTKDOCLINK > *child, <GTKDOCLINK HREF="GUINT" >guint</GTKDOCLINK > offset); void <A HREF="gnomedockband.html#GNOME-DOCK-BAND-SET-CHILD-OFFSET" >gnome_dock_band_set_child_offset</A > (<A HREF="gnomedockband.html" >GnomeDockBand</A > *band, <GTKDOCLINK HREF="GTKWIDGET" >GtkWidget</GTKDOCLINK > *child, <GTKDOCLINK HREF="GUINT" >guint</GTKDOCLINK > offset); <GTKDOCLINK HREF="GUINT" >guint</GTKDOCLINK > <A HREF="gnomedockband.html#GNOME-DOCK-BAND-GET-CHILD-OFFSET" >gnome_dock_band_get_child_offset</A > (<A HREF="gnomedockband.html" >GnomeDockBand</A > *band, <GTKDOCLINK HREF="GTKWIDGET" >GtkWidget</GTKDOCLINK > *child); void <A HREF="gnomedockband.html#GNOME-DOCK-BAND-MOVE-CHILD" >gnome_dock_band_move_child</A > (<A HREF="gnomedockband.html" >GnomeDockBand</A > *band, <GTKDOCLINK HREF="GLIST" >GList</GTKDOCLINK > *old_child, <GTKDOCLINK HREF="GUINT" >guint</GTKDOCLINK > new_num); <GTKDOCLINK HREF="GUINT" >guint</GTKDOCLINK > <A HREF="gnomedockband.html#GNOME-DOCK-BAND-GET-NUM-CHILDREN" >gnome_dock_band_get_num_children</A > (<A HREF="gnomedockband.html" >GnomeDockBand</A > *band); void <A HREF="gnomedockband.html#GNOME-DOCK-BAND-DRAG-BEGIN" >gnome_dock_band_drag_begin</A > (<A HREF="gnomedockband.html" >GnomeDockBand</A > *band, <A HREF="gnomedockitem.html" >GnomeDockItem</A > *item); <GTKDOCLINK HREF="GBOOLEAN" >gboolean</GTKDOCLINK > <A HREF="gnomedockband.html#GNOME-DOCK-BAND-DRAG-TO" >gnome_dock_band_drag_to</A > (<A HREF="gnomedockband.html" >GnomeDockBand</A > *band, <A HREF="gnomedockitem.html" >GnomeDockItem</A > *item, <GTKDOCLINK HREF="GINT" >gint</GTKDOCLINK > x, <GTKDOCLINK HREF="GINT" >gint</GTKDOCLINK > y); void <A HREF="gnomedockband.html#GNOME-DOCK-BAND-DRAG-END" >gnome_dock_band_drag_end</A > (<A HREF="gnomedockband.html" >GnomeDockBand</A > *band, <A HREF="gnomedockitem.html" >GnomeDockItem</A > *item); <A HREF="gnomedockitem.html" >GnomeDockItem</A >* <A HREF="gnomedockband.html#GNOME-DOCK-BAND-GET-ITEM-BY-NAME" >gnome_dock_band_get_item_by_name</A > (<A HREF="gnomedockband.html" >GnomeDockBand</A > *band, const char *name, <GTKDOCLINK HREF="GUINT" >guint</GTKDOCLINK > *position_return, <GTKDOCLINK HREF="GUINT" >guint</GTKDOCLINK > *offset_return); void <A HREF="gnomedockband.html#GNOME-DOCK-BAND-LAYOUT-ADD" >gnome_dock_band_layout_add</A > (<A HREF="gnomedockband.html" >GnomeDockBand</A > *band, <A HREF="gnomedocklayout.html" >GnomeDockLayout</A > *layout, <A HREF="gnomedock.html#GNOMEDOCKPLACEMENT" >GnomeDockPlacement</A > placement, <GTKDOCLINK HREF="GUINT" >guint</GTKDOCLINK > band_num); </PRE ></TD ></TR ></TABLE ></DIV ><DIV CLASS="REFSECT1" ><A NAME="AEN14540" ></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 > +----GnomeDockBand</PRE ></TD ></TR ></TABLE ></DIV ><DIV CLASS="REFSECT1" ><A NAME="AEN14546" ></A ><H2 >Description</H2 ><P ><SPAN CLASS="TYPE" >GnomeDockBand</SPAN > is a widget implementing a "dock band", i.e. a horizontal or vertical stripe containing dockable widgets.</P ><P >The application programmer does not normally need to use <SPAN CLASS="TYPE" >GnomeDockBand</SPAN >s directly; they are mostly used by the <SPAN CLASS="TYPE" >GnomeDock</SPAN > widget to implement its functionality. For an explanation of the way dock bands are used within a dock, check out the documentation for the <SPAN CLASS="TYPE" >GnomeDock</SPAN > widget.</P ></DIV ><DIV CLASS="REFSECT1" ><A NAME="AEN14554" ></A ><H2 >Details</H2 ><DIV CLASS="REFSECT2" ><A NAME="AEN14556" ></A ><H3 ><A NAME="GNOMEDOCKBAND-STRUCT" ></A >struct GnomeDockBand</H3 ><TABLE BORDER="0" BGCOLOR="#D6E8FF" WIDTH="100%" CELLPADDING="6" ><TR ><TD ><PRE CLASS="PROGRAMLISTING" >struct GnomeDockBand;</PRE ></TD ></TR ></TABLE ><P ></P ></DIV ><HR><DIV CLASS="REFSECT2" ><A NAME="AEN14561" ></A ><H3 ><A NAME="GNOMEDOCKBANDCHILD" ></A >struct GnomeDockBandChild</H3 ><TABLE BORDER="0" BGCOLOR="#D6E8FF" WIDTH="100%" CELLPADDING="6" ><TR ><TD ><PRE CLASS="PROGRAMLISTING" >struct GnomeDockBandChild { GtkWidget *widget; /* Maximum (requested) offset from the previous child. */ guint offset; /* Actual offset. */ guint real_offset; guint drag_offset; GtkAllocation drag_allocation; guint prev_space, foll_space; guint drag_prev_space, drag_foll_space; guint max_space_requisition; };</PRE ></TD ></TR ></TABLE ><P ></P ></DIV ><HR><DIV CLASS="REFSECT2" ><A NAME="AEN14566" ></A ><H3 ><A NAME="GNOME-DOCK-BAND-NEW" ></A >gnome_dock_band_new ()</H3 ><TABLE BORDER="0" BGCOLOR="#D6E8FF" WIDTH="100%" CELLPADDING="6" ><TR ><TD ><PRE CLASS="PROGRAMLISTING" ><GTKDOCLINK HREF="GTKWIDGET" >GtkWidget</GTKDOCLINK >* gnome_dock_band_new (void);</PRE ></TD ></TR ></TABLE ><P >Create a new GnomeDockBand widget.</P ><P ></P ><DIV CLASS="INFORMALTABLE" ><A NAME="AEN14573" ></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" ><SPAN CLASS="emphasis" ><I CLASS="EMPHASIS" >Returns</I ></SPAN > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" > The new GnomeDockBand widget.</TD ></TR ></TBODY ></TABLE ><P ></P ></DIV ></DIV ><HR><DIV CLASS="REFSECT2" ><A NAME="AEN14582" ></A ><H3 ><A NAME="GNOME-DOCK-BAND-SET-ORIENTATION" ></A >gnome_dock_band_set_orientation ()</H3 ><TABLE BORDER="0" BGCOLOR="#D6E8FF" WIDTH="100%" CELLPADDING="6" ><TR ><TD ><PRE CLASS="PROGRAMLISTING" >void gnome_dock_band_set_orientation (<A HREF="gnomedockband.html" >GnomeDockBand</A > *band, <GTKDOCLINK HREF="GTKORIENTATION" >GtkOrientation</GTKDOCLINK > orientation);</PRE ></TD ></TR ></TABLE ><P >Set the orientation for <TT CLASS="PARAMETER" ><I >band</I ></TT >.</P ><P ></P ><DIV CLASS="INFORMALTABLE" ><A NAME="AEN14591" ></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 >band</I ></TT > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" > A GnomeDockBand widget</TD ></TR ><TR ><TD WIDTH="20%" ALIGN="RIGHT" VALIGN="TOP" ><TT CLASS="PARAMETER" ><I >orientation</I ></TT > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" > New orientation for <TT CLASS="PARAMETER" ><I >band</I ></TT ></TD ></TR ></TBODY ></TABLE ><P ></P ></DIV ></DIV ><HR><DIV CLASS="REFSECT2" ><A NAME="AEN14605" ></A ><H3 ><A NAME="GNOME-DOCK-BAND-GET-ORIENTATION" ></A >gnome_dock_band_get_orientation ()</H3 ><TABLE BORDER="0" BGCOLOR="#D6E8FF" WIDTH="100%" CELLPADDING="6" ><TR ><TD ><PRE CLASS="PROGRAMLISTING" ><GTKDOCLINK HREF="GTKORIENTATION" >GtkOrientation</GTKDOCLINK > gnome_dock_band_get_orientation (<A HREF="gnomedockband.html" >GnomeDockBand</A > *band);</PRE ></TD ></TR ></TABLE ><P >Retrieve the orientation of the specified <TT CLASS="PARAMETER" ><I >band</I ></TT >.</P ><P ></P ><DIV CLASS="INFORMALTABLE" ><A NAME="AEN14614" ></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 >band</I ></TT > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" > A GnomeDockBand 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 orientation of <TT CLASS="PARAMETER" ><I >band</I ></TT >.</TD ></TR ></TBODY ></TABLE ><P ></P ></DIV ></DIV ><HR><DIV CLASS="REFSECT2" ><A NAME="AEN14628" ></A ><H3 ><A NAME="GNOME-DOCK-BAND-INSERT" ></A >gnome_dock_band_insert ()</H3 ><TABLE BORDER="0" BGCOLOR="#D6E8FF" WIDTH="100%" CELLPADDING="6" ><TR ><TD ><PRE CLASS="PROGRAMLISTING" ><GTKDOCLINK HREF="GBOOLEAN" >gboolean</GTKDOCLINK > gnome_dock_band_insert (<A HREF="gnomedockband.html" >GnomeDockBand</A > *band, <GTKDOCLINK HREF="GTKWIDGET" >GtkWidget</GTKDOCLINK > *child, <GTKDOCLINK HREF="GUINT" >guint</GTKDOCLINK > offset, <GTKDOCLINK HREF="GINT" >gint</GTKDOCLINK > position);</PRE ></TD ></TR ></TABLE ><P >Add <TT CLASS="PARAMETER" ><I >child</I ></TT > to <TT CLASS="PARAMETER" ><I >band</I ></TT > at the specified <TT CLASS="PARAMETER" ><I >position</I ></TT >, with the specified <TT CLASS="PARAMETER" ><I >offset</I ></TT > from the previous item (or from the beginning of the band, if this is the first item).</P ><P ></P ><DIV CLASS="INFORMALTABLE" ><A NAME="AEN14643" ></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 >band</I ></TT > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" > A GnomeDockBand widget</TD ></TR ><TR ><TD WIDTH="20%" ALIGN="RIGHT" VALIGN="TOP" ><TT CLASS="PARAMETER" ><I >child</I ></TT > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" > The widget to be added to <TT CLASS="PARAMETER" ><I >band</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 item</TD ></TR ><TR ><TD WIDTH="20%" ALIGN="RIGHT" VALIGN="TOP" ><TT CLASS="PARAMETER" ><I >position</I ></TT > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" > Position within the <TT CLASS="PARAMETER" ><I >band</I ></TT ></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" > <TT CLASS="LITERAL" >TRUE</TT > if successful, <TT CLASS="LITERAL" >FALSE</TT > if the operation fails.</TD ></TR ></TBODY ></TABLE ><P ></P ></DIV ></DIV ><HR><DIV CLASS="REFSECT2" ><A NAME="AEN14672" ></A ><H3 ><A NAME="GNOME-DOCK-BAND-PREPEND" ></A >gnome_dock_band_prepend ()</H3 ><TABLE BORDER="0" BGCOLOR="#D6E8FF" WIDTH="100%" CELLPADDING="6" ><TR ><TD ><PRE CLASS="PROGRAMLISTING" ><GTKDOCLINK HREF="GBOOLEAN" >gboolean</GTKDOCLINK > gnome_dock_band_prepend (<A HREF="gnomedockband.html" >GnomeDockBand</A > *band, <GTKDOCLINK HREF="GTKWIDGET" >GtkWidget</GTKDOCLINK > *child, <GTKDOCLINK HREF="GUINT" >guint</GTKDOCLINK > offset);</PRE ></TD ></TR ></TABLE ><P >Add <TT CLASS="PARAMETER" ><I >child</I ></TT > to <TT CLASS="PARAMETER" ><I >band</I ></TT > with the specified <TT CLASS="PARAMETER" ><I >offset</I ></TT > as the first element.</P ><P ></P ><DIV CLASS="INFORMALTABLE" ><A NAME="AEN14685" ></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 >band</I ></TT > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" > A GnomeDockBand widget</TD ></TR ><TR ><TD WIDTH="20%" ALIGN="RIGHT" VALIGN="TOP" ><TT CLASS="PARAMETER" ><I >child</I ></TT > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" > A widget to be added to <TT CLASS="PARAMETER" ><I >band</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 (in pixels) from the beginning of the band</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" > <TT CLASS="LITERAL" >TRUE</TT > if successful, <TT CLASS="LITERAL" >FALSE</TT > if the operation fails.</TD ></TR ></TBODY ></TABLE ><P ></P ></DIV ></DIV ><HR><DIV CLASS="REFSECT2" ><A NAME="AEN14709" ></A ><H3 ><A NAME="GNOME-DOCK-BAND-APPEND" ></A >gnome_dock_band_append ()</H3 ><TABLE BORDER="0" BGCOLOR="#D6E8FF" WIDTH="100%" CELLPADDING="6" ><TR ><TD ><PRE CLASS="PROGRAMLISTING" ><GTKDOCLINK HREF="GBOOLEAN" >gboolean</GTKDOCLINK > gnome_dock_band_append (<A HREF="gnomedockband.html" >GnomeDockBand</A > *band, <GTKDOCLINK HREF="GTKWIDGET" >GtkWidget</GTKDOCLINK > *child, <GTKDOCLINK HREF="GUINT" >guint</GTKDOCLINK > offset);</PRE ></TD ></TR ></TABLE ><P >Add <TT CLASS="PARAMETER" ><I >child</I ></TT > to <TT CLASS="PARAMETER" ><I >band</I ></TT > with the specified <TT CLASS="PARAMETER" ><I >offset</I ></TT > as the last element.</P ><P ></P ><DIV CLASS="INFORMALTABLE" ><A NAME="AEN14722" ></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 >band</I ></TT > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" > A GnomeDockBand widget</TD ></TR ><TR ><TD WIDTH="20%" ALIGN="RIGHT" VALIGN="TOP" ><TT CLASS="PARAMETER" ><I >child</I ></TT > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" > A widget to be added to <TT CLASS="PARAMETER" ><I >band</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 (in pixels) from the last item of the band</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" > <TT CLASS="LITERAL" >TRUE</TT > if successful, <TT CLASS="LITERAL" >FALSE</TT > if the operation fails.</TD ></TR ></TBODY ></TABLE ><P ></P ></DIV ></DIV ><HR><DIV CLASS="REFSECT2" ><A NAME="AEN14746" ></A ><H3 ><A NAME="GNOME-DOCK-BAND-SET-CHILD-OFFSET" ></A >gnome_dock_band_set_child_offset ()</H3 ><TABLE BORDER="0" BGCOLOR="#D6E8FF" WIDTH="100%" CELLPADDING="6" ><TR ><TD ><PRE CLASS="PROGRAMLISTING" >void gnome_dock_band_set_child_offset (<A HREF="gnomedockband.html" >GnomeDockBand</A > *band, <GTKDOCLINK HREF="GTKWIDGET" >GtkWidget</GTKDOCLINK > *child, <GTKDOCLINK HREF="GUINT" >guint</GTKDOCLINK > offset);</PRE ></TD ></TR ></TABLE ><P >Set the offset for the specified <TT CLASS="PARAMETER" ><I >child</I ></TT > of <TT CLASS="PARAMETER" ><I >band</I ></TT >.</P ><P ></P ><DIV CLASS="INFORMALTABLE" ><A NAME="AEN14757" ></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 >band</I ></TT > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" > A GnomeDockBand widget</TD ></TR ><TR ><TD WIDTH="20%" ALIGN="RIGHT" VALIGN="TOP" ><TT CLASS="PARAMETER" ><I >child</I ></TT > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" > Child of <TT CLASS="PARAMETER" ><I >band</I ></TT > whose offset must be changed</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" > New offset value for <TT CLASS="PARAMETER" ><I >child</I ></TT ></TD ></TR ></TBODY ></TABLE ><P ></P ></DIV ></DIV ><HR><DIV CLASS="REFSECT2" ><A NAME="AEN14776" ></A ><H3 ><A NAME="GNOME-DOCK-BAND-GET-CHILD-OFFSET" ></A >gnome_dock_band_get_child_offset ()</H3 ><TABLE BORDER="0" BGCOLOR="#D6E8FF" WIDTH="100%" CELLPADDING="6" ><TR ><TD ><PRE CLASS="PROGRAMLISTING" ><GTKDOCLINK HREF="GUINT" >guint</GTKDOCLINK > gnome_dock_band_get_child_offset (<A HREF="gnomedockband.html" >GnomeDockBand</A > *band, <GTKDOCLINK HREF="GTKWIDGET" >GtkWidget</GTKDOCLINK > *child);</PRE ></TD ></TR ></TABLE ><P >Retrieve the offset of <TT CLASS="PARAMETER" ><I >child</I ></TT > in <TT CLASS="PARAMETER" ><I >band</I ></TT >.</P ><P ></P ><DIV CLASS="INFORMALTABLE" ><A NAME="AEN14787" ></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 >band</I ></TT > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" > A GnomeDockBand widget</TD ></TR ><TR ><TD WIDTH="20%" ALIGN="RIGHT" VALIGN="TOP" ><TT CLASS="PARAMETER" ><I >child</I ></TT > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" > Child of <TT CLASS="PARAMETER" ><I >band</I ></TT > whose offset must be retrieved</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 offset of <TT CLASS="PARAMETER" ><I >child</I ></TT >.</TD ></TR ></TBODY ></TABLE ><P ></P ></DIV ></DIV ><HR><DIV CLASS="REFSECT2" ><A NAME="AEN14806" ></A ><H3 ><A NAME="GNOME-DOCK-BAND-MOVE-CHILD" ></A >gnome_dock_band_move_child ()</H3 ><TABLE BORDER="0" BGCOLOR="#D6E8FF" WIDTH="100%" CELLPADDING="6" ><TR ><TD ><PRE CLASS="PROGRAMLISTING" >void gnome_dock_band_move_child (<A HREF="gnomedockband.html" >GnomeDockBand</A > *band, <GTKDOCLINK HREF="GLIST" >GList</GTKDOCLINK > *old_child, <GTKDOCLINK HREF="GUINT" >guint</GTKDOCLINK > new_num);</PRE ></TD ></TR ></TABLE ><P ></P ><DIV CLASS="INFORMALTABLE" ><A NAME="AEN14814" ></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 >band</I ></TT > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" > </TD ></TR ><TR ><TD WIDTH="20%" ALIGN="RIGHT" VALIGN="TOP" ><TT CLASS="PARAMETER" ><I >old_child</I ></TT > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" > </TD ></TR ><TR ><TD WIDTH="20%" ALIGN="RIGHT" VALIGN="TOP" ><TT CLASS="PARAMETER" ><I >new_num</I ></TT > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" > </TD ></TR ></TBODY ></TABLE ><P ></P ></DIV ></DIV ><HR><DIV CLASS="REFSECT2" ><A NAME="AEN14831" ></A ><H3 ><A NAME="GNOME-DOCK-BAND-GET-NUM-CHILDREN" ></A >gnome_dock_band_get_num_children ()</H3 ><TABLE BORDER="0" BGCOLOR="#D6E8FF" WIDTH="100%" CELLPADDING="6" ><TR ><TD ><PRE CLASS="PROGRAMLISTING" ><GTKDOCLINK HREF="GUINT" >guint</GTKDOCLINK > gnome_dock_band_get_num_children (<A HREF="gnomedockband.html" >GnomeDockBand</A > *band);</PRE ></TD ></TR ></TABLE ><P >Retrieve the number of children in <TT CLASS="PARAMETER" ><I >band</I ></TT >.</P ><P ></P ><DIV CLASS="INFORMALTABLE" ><A NAME="AEN14840" ></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 >band</I ></TT > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" > A GnomeDockBand 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 number of children in <TT CLASS="PARAMETER" ><I >band</I ></TT >.</TD ></TR ></TBODY ></TABLE ><P ></P ></DIV ></DIV ><HR><DIV CLASS="REFSECT2" ><A NAME="AEN14854" ></A ><H3 ><A NAME="GNOME-DOCK-BAND-DRAG-BEGIN" ></A >gnome_dock_band_drag_begin ()</H3 ><TABLE BORDER="0" BGCOLOR="#D6E8FF" WIDTH="100%" CELLPADDING="6" ><TR ><TD ><PRE CLASS="PROGRAMLISTING" >void gnome_dock_band_drag_begin (<A HREF="gnomedockband.html" >GnomeDockBand</A > *band, <A HREF="gnomedockitem.html" >GnomeDockItem</A > *item);</PRE ></TD ></TR ></TABLE ><P ></P ><DIV CLASS="INFORMALTABLE" ><A NAME="AEN14861" ></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 >band</I ></TT > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" > </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" > </TD ></TR ></TBODY ></TABLE ><P ></P ></DIV ></DIV ><HR><DIV CLASS="REFSECT2" ><A NAME="AEN14874" ></A ><H3 ><A NAME="GNOME-DOCK-BAND-DRAG-TO" ></A >gnome_dock_band_drag_to ()</H3 ><TABLE BORDER="0" BGCOLOR="#D6E8FF" WIDTH="100%" CELLPADDING="6" ><TR ><TD ><PRE CLASS="PROGRAMLISTING" ><GTKDOCLINK HREF="GBOOLEAN" >gboolean</GTKDOCLINK > gnome_dock_band_drag_to (<A HREF="gnomedockband.html" >GnomeDockBand</A > *band, <A HREF="gnomedockitem.html" >GnomeDockItem</A > *item, <GTKDOCLINK HREF="GINT" >gint</GTKDOCLINK > x, <GTKDOCLINK HREF="GINT" >gint</GTKDOCLINK > y);</PRE ></TD ></TR ></TABLE ><P ></P ><DIV CLASS="INFORMALTABLE" ><A NAME="AEN14884" ></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 >band</I ></TT > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" > </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" > </TD ></TR ><TR ><TD WIDTH="20%" ALIGN="RIGHT" VALIGN="TOP" ><TT CLASS="PARAMETER" ><I >x</I ></TT > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" > </TD ></TR ><TR ><TD WIDTH="20%" ALIGN="RIGHT" VALIGN="TOP" ><TT CLASS="PARAMETER" ><I >y</I ></TT > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" > </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" > </TD ></TR ></TBODY ></TABLE ><P ></P ></DIV ></DIV ><HR><DIV CLASS="REFSECT2" ><A NAME="AEN14909" ></A ><H3 ><A NAME="GNOME-DOCK-BAND-DRAG-END" ></A >gnome_dock_band_drag_end ()</H3 ><TABLE BORDER="0" BGCOLOR="#D6E8FF" WIDTH="100%" CELLPADDING="6" ><TR ><TD ><PRE CLASS="PROGRAMLISTING" >void gnome_dock_band_drag_end (<A HREF="gnomedockband.html" >GnomeDockBand</A > *band, <A HREF="gnomedockitem.html" >GnomeDockItem</A > *item);</PRE ></TD ></TR ></TABLE ><P ></P ><DIV CLASS="INFORMALTABLE" ><A NAME="AEN14916" ></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 >band</I ></TT > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" > </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" > </TD ></TR ></TBODY ></TABLE ><P ></P ></DIV ></DIV ><HR><DIV CLASS="REFSECT2" ><A NAME="AEN14929" ></A ><H3 ><A NAME="GNOME-DOCK-BAND-GET-ITEM-BY-NAME" ></A >gnome_dock_band_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_band_get_item_by_name (<A HREF="gnomedockband.html" >GnomeDockBand</A > *band, const char *name, <GTKDOCLINK HREF="GUINT" >guint</GTKDOCLINK > *position_return, <GTKDOCLINK HREF="GUINT" >guint</GTKDOCLINK > *offset_return);</PRE ></TD ></TR ></TABLE ><P >Retrieve a named item from <TT CLASS="PARAMETER" ><I >band</I ></TT >, and return its position and offset in *<TT CLASS="PARAMETER" ><I >position_return</I ></TT > and <TT CLASS="PARAMETER" ><I >offset_return</I ></TT >.</P ><P ></P ><DIV CLASS="INFORMALTABLE" ><A NAME="AEN14942" ></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 >band</I ></TT > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" > A GnomeDockBand 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 child to be retrieved</TD ></TR ><TR ><TD WIDTH="20%" ALIGN="RIGHT" VALIGN="TOP" ><TT CLASS="PARAMETER" ><I >position_return</I ></TT > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" > Pointer to a variable holding the position of the named child</TD ></TR ><TR ><TD WIDTH="20%" ALIGN="RIGHT" VALIGN="TOP" ><TT CLASS="PARAMETER" ><I >offset_return</I ></TT > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" > Pointer to a variable holding the offset of the named child</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 child whose name is <TT CLASS="PARAMETER" ><I >name</I ></TT >, or <TT CLASS="LITERAL" >NULL</TT > if no child of <TT CLASS="PARAMETER" ><I >band</I ></TT > has such name.</TD ></TR ></TBODY ></TABLE ><P ></P ></DIV ></DIV ><HR><DIV CLASS="REFSECT2" ><A NAME="AEN14970" ></A ><H3 ><A NAME="GNOME-DOCK-BAND-LAYOUT-ADD" ></A >gnome_dock_band_layout_add ()</H3 ><TABLE BORDER="0" BGCOLOR="#D6E8FF" WIDTH="100%" CELLPADDING="6" ><TR ><TD ><PRE CLASS="PROGRAMLISTING" >void gnome_dock_band_layout_add (<A HREF="gnomedockband.html" >GnomeDockBand</A > *band, <A HREF="gnomedocklayout.html" >GnomeDockLayout</A > *layout, <A HREF="gnomedock.html#GNOMEDOCKPLACEMENT" >GnomeDockPlacement</A > placement, <GTKDOCLINK HREF="GUINT" >guint</GTKDOCLINK > band_num);</PRE ></TD ></TR ></TABLE ><P ></P ><DIV CLASS="INFORMALTABLE" ><A NAME="AEN14979" ></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 >band</I ></TT > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" > </TD ></TR ><TR ><TD WIDTH="20%" ALIGN="RIGHT" VALIGN="TOP" ><TT CLASS="PARAMETER" ><I >layout</I ></TT > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" > </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" > </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" > </TD ></TR ></TBODY ></TABLE ><P ></P ></DIV ></DIV ></DIV ><DIV CLASS="REFSECT1" ><A NAME="AEN15000" ></A ><H2 >See Also</H2 ><P ><A HREF="gnomedock.html" >GnomeDock</A > <A HREF="gnomedockitem.html" >GnomeDockItem</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="gnomedialog.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="gnomedockitem.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 >GnomeDialog</B ></FONT ></TD ><TD COLSPAN="2" ALIGN="right" ><FONT COLOR="#FFFFFF" SIZE="3" ><B >GnomeDockItem</B ></FONT ></TD ></TR ></TABLE ></DIV ></BODY ></HTML >