<!-- ##### 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: