<!-- ##### SECTION Title ##### -->
GnomeDockLayout

<!-- ##### SECTION Short_Description ##### -->
A widget for saving and retrieving the layout of a
<type>GnomeDock</type> widget.

<!-- ##### SECTION Long_Description ##### -->
<para>
The <type>GnomeDockLayout</type> widget is meant to make it simple for
programmers to handle the layout of a <type>GnomeDock</type> widget.
</para>

<para>
<type>GnomeDockLayout</type> can contain an arbitrary number of
<type>GnomeDockItem</type> widgets, each of them with its own
placement information.  It is possible to "extract" a layout from an
existing <type>GnomeDock</type> widget, as well as adding the items
present in a <type>GnomeDockLayout</type> to it.  Moreover,
<type>GnomeDockLayout</type> is able to create a layout configuration
string that can be later used to re-construct the layout on a brand
new <type>GnomeDockLayout</type> widget.
</para>

<para>
As a consequence, <type>GnomeDockLayout</type> is very useful to save
and retrieve <type>GnomeDock</type> configurations into files.  For
example, <type>GnomeApp</type> uses <type>GnomeDockLayout</type> to
create a default layout configuration, override it with the
user-specific configuration file, and finally apply it to it
<type>GnomeDock</type>.
</para>

<!-- ##### SECTION See_Also ##### -->
<para>
#GnomeDock
#GnomeDockItem
#GnomeDockBand
</para>

<!-- ##### STRUCT GnomeDockLayout ##### -->
<para>

</para>


<!-- ##### STRUCT GnomeDockLayoutItem ##### -->
<para>

</para>


<!-- ##### FUNCTION gnome_dock_layout_new ##### -->
<para>

</para>

@Returns: 


<!-- ##### FUNCTION gnome_dock_layout_add_item ##### -->
<para>

</para>

@layout: 
@item: 
@placement: 
@band_num: 
@band_position: 
@offset: 
@Returns: 


<!-- ##### FUNCTION gnome_dock_layout_add_floating_item ##### -->
<para>

</para>

@layout: 
@item: 
@x: 
@y: 
@orientation: 
@Returns: 


<!-- ##### FUNCTION gnome_dock_layout_get_item ##### -->
<para>

</para>

@layout: 
@item: 
@Returns: 


<!-- ##### FUNCTION gnome_dock_layout_get_item_by_name ##### -->
<para>

</para>

@layout: 
@name: 
@Returns: 


<!-- ##### FUNCTION gnome_dock_layout_remove_item ##### -->
<para>

</para>

@layout: 
@item: 
@Returns: 


<!-- ##### FUNCTION gnome_dock_layout_remove_item_by_name ##### -->
<para>

</para>

@layout: 
@name: 
@Returns: 


<!-- ##### FUNCTION gnome_dock_layout_create_string ##### -->
<para>

</para>

@layout: 
@Returns: 


<!-- ##### FUNCTION gnome_dock_layout_parse_string ##### -->
<para>

</para>

@layout: 
@string: 
@Returns: 


<!-- ##### FUNCTION gnome_dock_layout_add_to_dock ##### -->
<para>

</para>

@layout: 
@dock: 
@Returns: