DESIGN (xvobjects) functions
LIBRARY ROUTINE
xvw_create_notebook - create a notebook object
LIBRARY CALL
xvobject xvw_create_notebook(
xvobject parent,
char *name)
INPUT
- parent - the parent of the notebook object; NULL will cause a
default toplevel to be created automatically
- name - a name for this particular instance of the object
(for use in app-defaults files, etc)
OUTPUT
none
RETURN VALUE
The notebook object on success, NULL on failure
DESCRIPTION
The notebook object is designed for doing notebook of
objects that are subclassed from the Manager widget.
Only objects subclassed from the manager widget (not
the manager object) may be created as children of the
notebook object. Such objects include area objects,
image objects, zoom objects, viewport objects, and so on.
See Chapter 1, "Introduction", of the Programming Services
Manual, Volume 3, for diagrams depicting the objects that
are subclassed from the Manager widget.
The notebook object allows you to do quick and easy
notebook when a variety of such objects share a common
backplane. You may specify the number of objects
that should appear in a single row; relative notebook
specifications are not needed.
The notebook object is especially effective when laying
out objects of the same type, as it will preserve
proportionality between the objects. It is often used
in applications such as xprism, where the user
will be interactively creating new objects to display
data. The application need not implement special
code to do appropriate notebook of new objects as they
are created, since the notebook object does it
automatically according to initial specifications.
ADDITIONAL INFORMATION
none
EXAMPLES
none
SIDE EFFECTS
none
RESTRICTIONS
none
MODIFICATION
none
FILES
$DESIGN/objects/library/xvobjects/src/Notebook.c
SEE ALSO
xvobjects(3)
COPYRIGHT
Copyright (C) 1993 - 1997, Khoral Research, Inc. ("KRI") All rights reserved.