GnomeMDIChild is an abstract class for GnomeMDI
children. In order to use it, you have to either derive a new class from it
and define the proper virtual functions in its parent
GnomeMDIChildClass structure or use the
GnomeMDIGenericChild class that allows to specify the relevant
functions on a per-instance rather than on per-class basis.
Each instance of GnomeMDIChild class defines a name for the child and possibly
a menu template for document-specific menus that will be merged with the global
MDI menus. The menu template is set using the gnome_mdi_child_set_menu_template()
The GnomeMDIChild class has four virtual functions that are used by
create_view must be defined for each subclass and must return a pointer to a
GtkWidget representing a new view of the document.
create_menus must return a GList of menu items and can be used instead of the
child's menu template. If both template and this function are defined, only the
template (which can be defined on a per-instance basis) is used.
get_config_string must return a string that represents the state of the child
and will be used to save and restore state of the MDI children bewtween sessions.
set_label must return a pointer to a GtkWidget that will be used as notebook and
menu item label for this child.
create_view function must be defined for each subclass and the GnomeMDIChild
class provides a simple default implementation of set_label; create_menus and get_config_string
may be undefined.
Creates a new view of a child (a GtkWidget) adds it to the list
of the views and returns a pointer to it. Virtual function
that has to be specified for classes derived from GnomeMDIChild
is used to create the new view.
Sets the template for menus that are added and removed when differrent
children get activated. This way, each child can modify the MDI menubar
to suit its needs. If no template is set, the create_menus virtual
function will be used for creating these menus (it has to return a
GList of menu items). If no such function is specified, the menubar will
be unchanged by MDI children.
A pointer to a GnomeMDIChild object.
A GnomeUIInfo array describing the child specific menus.