Miscellaneous Objects

GnomeClient

Library

Gnome

Header File

libgnomeui/gnome-client.h

Description

GnomeClient is a GtkObject which conceals the details of session management and provides a nice session management API for Gnome applications. See the section called Session Management in the chapter called Gnome Application Basics for more information.

GnomeDEntryEdit

Library

Gnome

Header File

libgnomeui/gnome-dentry-edit.h

Description

GnomeDEntryEdit is a very specialized object; it is a sort of "widget manager" that creates and keeps track of two child widgets, an "easy" and an "advanced" page. The two pages combine to let the user edit a Gnome .desktop entry, as described in the section called .desktop Entries in the chapter called Creating Your Source Tree. GnomeDEntryEdit is intended to be used in conjunction with a preexisting GtkNotebook. It isn't a GtkNotebook subclass itself, because you might want to use the GtkNotebook in a GnomePropertyBox. The Gnome panel and the Gnome menu editor use this widget.

Figure 35. The GnomeDEntryEdit object created the two widgets in this notebook

GnomeDockLayout

Library

Gnome

Header File

libgnomeui/gnome-dock-layout.h

Description

GnomeDockLayout maintains information about the current position of items in a GnomeDock. It can load and save this information; GnomeDock uses this functionality to save and load toolbar positions. Recall that GnomeApp uses the GnomeDock widget for its layout.

GnomeMDIChild

Library

Gnome

Header File

libgnomeui/gnome-mdi-child.h

Description

GnomeMDIChild is an abstract interface; you must derive your own subclass or use GnomeMDIGenericChild in order to take advantage of the GnomeMDI object. GnomeMDI is a "multiple document interface" manager.

GnomeMDIGenericChild

Library

Gnome

Header File

libgnomeui/gnome-mdi-generic-child.h

Description

A generic implementation of GnomeMDIChild. For complex applications, you may need to write a custom implementation.

GnomeMDI

Library

Gnome

Header File

libgnomeui/gnome-mdi.h

Description

GnomeMDI keeps track of multiple documents. Users can configure how the documents are arranged in the application; they might be placed in a GtkNotebook in the same GtkWindow, or each document might have its own GtkWindow. Also, users can drag the notebook pages out of the GtkWindow, and they will be reparented into their own toplevel window.

GtkData

Library

GTK+

Header File

gtk/gtkdata.h

Description

GtkData is an abstract base class for a piece of data that might be shared between multiple objects. Right now its interface is empty; in the future, there may be generic operations for all GtkData objects.

GtkAdjustment

Library

GTK+

Header File

gtk/gtkadjustment.h

Description

GtkAdjustment represents a numeric value. It can also store a maximum and minimum value, a "step increment," a "page increment," and a "page size." Some objects don't use all the fields in the adjustment, and some interpret them slightly differently. A GtkRange (including its GtkScale and GtkScrollbar subclasses) will allow the user to move the slider between the minimum and maximum values. Clicking the arrows on the end of a GtkScrollbar nudges the scroll bar by one "step increment"; clicking them with the middle button moves one "page increment." The "page size" determines the size of the scrollbar slider (it's the length of the "visible" page in the same units as the overall range). GtkAdjustment emits signals when its values change.

GtkTooltips

Library

GTK+

Header File

gtk/gtktooltips.h

Description

GtkTooltips associates some help text with a widget. If the user holds the mouse pointer still over the widget for a short time, a tooltip will appear displaying the help text. GtkTooltips can also store some "private" text; you might use this with a GtkTipsQuery to display more extensive help. the section called Tooltips in the chapter called The Main Window: GnomeApp has more information on tooltips.

GtkItemFactory

Library

GTK+

Header File

gtk/gtkitemfactory.h

Description

GtkItemFactory is intended to simplify menu creation; Gnome applications should use GnomeUIInfo templates instead (see the section called Menus and Toolbars with GnomeUIInfo in the chapter called The Main Window: GnomeApp).