GNOME Developer

GNOME Druids

GNOME Druid is a set of widgets that provide a consistent way to walk users through several stages of an initial configuration process. It fulfills the role "Wizards" play in the windows world.

The main widget in the Druid is the GnomeDruid widget. It is a container widget that holds the information pages inside. It handles all of the control flow during the setup. It will go through all the pages in it in a linear fashion by default, and keeps track of which page is currently shown. Every page in it is inherits from the GnomeDruidPage virtual widget.

There are actually three different GnomeDruidPage widgets currently available. They are the GnomeDruidPageStart, the GnomeDruidPageStandard, and the GnomeDruidPageFinish. These widgets are, quite obviously the beginning, middle and end pages of a druid. The first and last are quite similar in look, and let you set a large number of properties, such as color, title, text, and watermark and logo images. The Standard page is a little less defined, has a GtkVBox that you can pack your own widgets into. While these widgets are sufficient for most tasks, if you do need a custom widget, you can inherit from GnomeDruidPage.

Every time the user changes pages, the current page will send out a "next" or "back" signal to let the application know. It can select which page to show next based on how you handle the signal. In addition, the page can change the sensitivity of the "Next" and "Back" buttons to restrict the user from progressing until enough information has been entered.

Reference

Home | News | What's New | Architecture | Documentation | Tools | Getting Involved | External Resources | Projects | Sitemap

Last modified 1999/11/10 19:27:27

webmaster@gnome.org

Website hosted by Red Hat, Inc.