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 GnomeDockLayoutItem
struct 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.