NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.52">Name GnomeDockLayout -- A widget for saving and retrieving the layout of a
GnomeDock widget.
Synopsis
#include <gnome.h>
struct GnomeDockLayout ;
struct GnomeDockLayoutItem ;
GnomeDockLayout * gnome_dock_layout_new (void);
gboolean gnome_dock_layout_add_item (GnomeDockLayout *layout,
GnomeDockItem *item,
GnomeDockPlacement placement,
gint band_num,
gint band_position,
gint offset);
gboolean gnome_dock_layout_add_floating_item
(GnomeDockLayout *layout,
GnomeDockItem *item,
gint x,
gint y,
GtkOrientation orientation);
GnomeDockLayoutItem * gnome_dock_layout_get_item
(GnomeDockLayout *layout,
GnomeDockItem *item);
GnomeDockLayoutItem * gnome_dock_layout_get_item_by_name
(GnomeDockLayout *layout,
const gchar *name);
gboolean gnome_dock_layout_remove_item (GnomeDockLayout *layout,
GnomeDockItem *item);
gboolean gnome_dock_layout_remove_item_by_name
(GnomeDockLayout *layout,
const gchar *name);
gchar * gnome_dock_layout_create_string (GnomeDockLayout *layout);
gboolean gnome_dock_layout_parse_string (GnomeDockLayout *layout,
const gchar *string);
gboolean gnome_dock_layout_add_to_dock (GnomeDockLayout *layout,
GnomeDock *dock);
Object Hierarchy
GtkObject
+----GnomeDockLayout
Description The GnomeDockLayout widget is meant to make it simple for
programmers to handle the layout of a GnomeDock widget.
GnomeDockLayout can contain an arbitrary number of
GnomeDockItem widgets, each of them with its own
placement information. It is possible to "extract" a layout from an
existing GnomeDock widget, as well as adding the items
present in a GnomeDockLayout to it. Moreover,
GnomeDockLayout is able to create a layout configuration
string that can be later used to re-construct the layout on a brand
new GnomeDockLayout widget.
As a consequence, GnomeDockLayout is very useful to save
and retrieve GnomeDock configurations into files. For
example, GnomeApp uses GnomeDockLayout to
create a default layout configuration, override it with the
user-specific configuration file, and finally apply it to it
GnomeDock .
Details struct GnomeDockLayoutItemstruct GnomeDockLayoutItem
{
GnomeDockItem *item;
GnomeDockPlacement placement;
union
{
struct
{
gint x;
gint y;
GtkOrientation orientation;
} floating;
struct
{
gint band_num;
gint band_position;
gint offset;
} docked;
} position;
};
gnome_dock_layout_add_item ()Add item to layout with the specified parameters.
gnome_dock_layout_add_floating_item ()Add item to layout as a floating item with the
specified (x , y ) position and orientation .
gnome_dock_layout_get_item ()Retrieve a layout item.
gnome_dock_layout_get_item_by_name ()Retrieve the dock item named name .
gnome_dock_layout_remove_item ()Remove the specified item from layout .
gnome_dock_layout_remove_item_by_name ()gboolean gnome_dock_layout_remove_item_by_name
(GnomeDockLayout *layout,
const gchar *name);
Remove the item named name from layout .
gnome_dock_layout_create_string ()Generate a string describing the layout in layout .
gnome_dock_layout_parse_string ()gboolean gnome_dock_layout_parse_string (GnomeDockLayout *layout,
const gchar *string);
Parse the layout string string , and move around the
items in layout accordingly.
gnome_dock_layout_add_to_dock ()Add all the items in layout to the specified dock .