DESIGN (xvobjects) functions
LIBRARY ROUTINE
xvw_create_layout - create a layout object
LIBRARY CALL
xvobject xvw_create_layout(
xvobject parent,
char *name)
INPUT
- parent - the parent of the layout 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 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.