The GNOME druid is a system for assisting the user with installing
a service. It is roughly equivalent in functionality to the
"Wizards" available in Windows.
There are two major parts of the druid, the Gnome.Druid widget, and
the set of W(Gnome.DruidPage) widgets. The Gnome.Druid widget is the
main widget that interacts with the user. It has a Next, a Prev,
and a Cancel button, and acts as a container for the pages. It is
not a top-level window, so it needs to be put in a W(GTK.Window) in
almost all cases. The W(Gnome.DruidPage) is a virtual widget, from
which all of the actual content of the page inherits from. There
are currently three of these available within gnome-libs.
GNOME druids are fairly simple to program with. You start by
creating a GnomeDruid into which you put all of your pages. This
widget will handle the presentation of the W(GnomeDruidPage) widgets.
You then create all appropriate W(GnomeDruidPage) widgets. There
are three implementations of these, although there is no reason why
more couldn't be written. They are the W(GnomeDruidPageStart), the
W(GnomeDruidPageStandard), and the W(GnomeDruidPageFinish). The
W(GnomeDruidPageStandard) acts as a W(Container), and is probably
the most commonly used druid page. The other ones, as their names
might suggest, are used at the endpoints of the druid. More
information on the specific properties of these widgets can be
found on their respective pages.
You will need to add the pages to the druid in order for them to
appear. The druid itself keeps an internal list of all pages, and
using the prepend_page(), append_page(), and insert_page()
functions will place them into it.
Signals:
cancel
This signal is emitted when the "cancel" button has been
pressed. Note that the current druid page has the option to trap
the signal and use it, if need be, preventing this signal from
being emitted.
Gnome.DockLayoutItem()->position()