DESIGN (xvobjects) functions


LIBRARY ROUTINE

xvw_create_notebook - create a notebook object

LIBRARY CALL

xvobject xvw_create_notebook(
   xvobject parent,
   char     *name)

INPUT

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.