<!-- ##### SECTION Title ##### -->
GnomeDockItem

<!-- ##### SECTION Short_Description ##### -->
A dockable widget.

<!-- ##### SECTION Long_Description ##### -->
<para>
<type>GnomeDockItem</type> is a container widget that can be used to
make widgets dockable.  "Making a widget dockable" means that the
widget gets a handle through which users can drag it around the dock
widget or detach it so that it gets displayed into its own window
(thus becoming a "floating" item).
</para>

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

<!-- ##### STRUCT GnomeDockItem ##### -->
<para>

</para>


<!-- ##### ENUM GnomeDockItemBehavior ##### -->
<para>
This enumeration can be used to customize the behavior of a dock item.
Every value represents a property bit, so that the properties can be
combined together by using the OR (`|') operator.
</para>

<para>
The special value GNOME_DOCK_ITEM_BEH_NORMAL specifies the ``normal''
(default) behavior, and means to have all the properties disabled (and
thus the corresponding bits set to zero).
</para>

<itemizedlist>
<listitem><para>GNOME_DOCK_ITEM_BEH_EXCLUSIVE specifies that the dock
item is always the only one in its band. </para></listitem>
<listitem><para>GNOME_DOCK_ITEM_BEH_NEVER_FLOATING specifies that
users cannot detach the dock item from the dock. </para> </listitem>
<listitem><para>GNOME_DOCK_ITEM_BEH_NEVER_VERTICAL specifies that the
dock item must be kept horizontal, and users cannot move it to a
vertical band.</para></listitem>
<listitem><para>GNOME_DOCK_ITEM_BEH_NEVER_HORIZONTAL specifies that
the dock item must be kept horizontal, and users cannot move it to a
vertical band.</para></listitem>
<listitem><para>GNOME_DOCK_ITEM_BEH_LOCKED specifies that users cannot
drag the item around.</para></listitem>
</itemizedlist>

<!-- ##### MACRO GNOME_DOCK_ITEM_NOT_LOCKED ##### -->
<para>

</para>

@x: 


<!-- ##### FUNCTION gnome_dock_item_new ##### -->
<para>

</para>

@name: 
@behavior: 
@Returns: 


<!-- ##### FUNCTION gnome_dock_item_get_child ##### -->
<para>

</para>

@dock_item: 
@Returns: 


<!-- ##### FUNCTION gnome_dock_item_get_name ##### -->
<para>

</para>

@dock_item: 
@Returns: 


<!-- ##### FUNCTION gnome_dock_item_set_shadow_type ##### -->
<para>

</para>

@dock_item: 
@type: 


<!-- ##### FUNCTION gnome_dock_item_get_shadow_type ##### -->
<para>

</para>

@dock_item: 
@Returns: 


<!-- ##### FUNCTION gnome_dock_item_set_orientation ##### -->
<para>

</para>

@dock_item: 
@orientation: 
@Returns: 


<!-- ##### FUNCTION gnome_dock_item_get_orientation ##### -->
<para>

</para>

@dock_item: 
@Returns: 


<!-- ##### FUNCTION gnome_dock_item_get_behavior ##### -->
<para>

</para>

@dock_item: 
@Returns: 


<!-- ##### FUNCTION gnome_dock_item_detach ##### -->
<para>

</para>

@item: 
@x: 
@y: 
@Returns: 


<!-- ##### FUNCTION gnome_dock_item_attach ##### -->
<para>

</para>

@item: 
@parent: 
@x: 
@y: 


<!-- ##### FUNCTION gnome_dock_item_grab_pointer ##### -->
<para>

</para>

@item: 


<!-- ##### FUNCTION gnome_dock_item_drag_floating ##### -->
<para>

</para>

@item: 
@x: 
@y: 


<!-- ##### FUNCTION gnome_dock_item_handle_size_request ##### -->
<para>

</para>

@item: 
@requisition: 


<!-- ##### FUNCTION gnome_dock_item_get_floating_position ##### -->
<para>

</para>

@item: 
@x: 
@y: 


<!-- ##### SIGNAL GnomeDockItem::dock-drag-begin ##### -->
<para>
This signal is emitted as soon as the user starts dragging the dock item.
</para>

@dockitem: the object which received the signal.

<!-- ##### SIGNAL GnomeDockItem::dock-drag-end ##### -->
<para>
This signal is emitted at the end of a dock item drag.
</para>

@dockitem: the object which received the signal.

<!-- ##### SIGNAL GnomeDockItem::dock-drag-motion ##### -->
<para>
This signal is emitted while the item is being dragged and reports
that the pointer position has changed.
</para>

@dockitem: the object which received the signal.
@arg1: the new X coordinate of the upper left corner of the item.
@arg2: the new Y coordinate of the upper left corner of the item.

<!-- ##### SIGNAL GnomeDockItem::dock-detach ##### -->
<para>
This signal is emitted when an item is detached from its parent dock
band and thus becomes a floating item.
</para>

@dockitem: the object which received the signal.

<!-- ##### ARG GnomeDockItem:shadow ##### -->
<para>

</para>

<!-- ##### ARG GnomeDockItem:orientation ##### -->
<para>

</para>