DESIGN (xvobjects) functions


LIBRARY ROUTINE

xvw_create_layout - create a layout object

LIBRARY CALL

xvobject xvw_create_layout(
   xvobject parent,
   char     *name)

INPUT

OUTPUT

none

RETURN VALUE

The layout object on success, NULL on failure

DESCRIPTION

The layout object is designed for doing layout 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 layout 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 layout object allows you to do quick and easy layout 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 layout specifications are not needed.

The layout 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 layout of new objects as they are created, since the layout 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/Layout.c

SEE ALSO

xvobjects(3)

COPYRIGHT

Copyright (C) 1993 - 1997, Khoral Research, Inc. ("KRI") All rights reserved.