GnomeDock is a container widget designed to let users move around
widgets such as toolbars, menubars and so on.
Every GnomeDock contains a widget called the "client area". On the
four sides of the client area, there are four "dock areas", which
can contain an arbitrary number of dockable widgets. All the
dockable widgets should be GnomeDockItem widgets; the GnomeDockItem
widget can in turn contain any kind of widget, and implements the
dragging functionality: every GnomeDockItem has a handle that users
can use to move them within the dock, or even move them outside it,
so that they become "floating items".
Every "dock area" is implemented by means of zero or more "dock
bands": a dock band is a horizontal or vertical stripe containing
one or more dock items, and is implemented by the GnomeDockBand
widget. Items are ordered from top to bottom in vertical bands, and
from left to right in horizontal bands. Every dock item in a band
is given an offset value that defines the distance, in pixels, from
the previous item in the same band; if the item is first in the
band, the offset defines the distance from the start of the band.
As a consequence, the position of an item in the dock can be
specified by means of the following values: a "placement"
specifying what area is being used (top, bottom, left, right), a
"band number" specifying the number of the band within the
specified area, a "position" within the band and a "offset" from
the previous item in the same band.
Signals:
layout_changed