Packed Widgets(3W) UNIX System V Packed Widgets(3W)
NAME
PackedWidget: OlCreatePackedWidgetList, OlPackedWidget - a convenience
routine that allows an application to create a widget tree or subtree in
one call
SYNOPSIS
#include <Intrinsic.h>
#include <StringDefs.h>
#include <OpenLook.h>
typedef struct {
Widget widgetreturned;
String name;
WidgetClass *classptr;
Widget *parentptr;
String descendant;
ArgList resources;
Cardinal numresources;
Boolean managed;
} OlPackedWidget;
Widget = OlCreatePackedWidgetList(pwlist, numpw)
OlPackedWidget *pwlist;
Cardinal numpw;
DESCRIPTION
Create Widget (Sub)Trees in One Call
The OlCreatePackedWidgetList() routine and its associated OlPackedWidget
structure allow an application to create a widget tree or subtree in one
call.
The tree is pointing to pwlist. Each element in this array is of the
type OlPackedWidget. This structure gives all the information needed to
create a new widget:
widgetreturned
will contain the ID of the newly created widget.
name is the name of the widget that will be created.
classptr
is a pointer to the WidgetClass pointer for the new widget. This
gives the class of widget to create. It is a pointer to the
pointer because typically the pointer itself is an external value
that is not suitable for using in an array initialization; the
pointer to the pointer is.
parentptr
is a pointer to the widget ID of the intended parent of the new
widget or the ID of an indirect widget that "knows who the parent
is" (see below). This value may point to a .widget member in
another PackedWidget item; if the parent is an indirect widget,
10/89 Page 1
Packed Widgets(3W) UNIX System V Packed Widgets(3W)
it must appear earlier in the list.
descendant
is the name of a resource available in the widget identified by
parentptr. The value of this resource is the ID of the real
parent for the new widget.
If the .descendant value is not zero, .parent is expected to
identify an indirect parent that is interrogated for the ID of
the real parent. If this value is zero, .parent is expected to
identify the real parent.
resources
is the resource array to use when creating the new widget.
numresources
is the number of resources in the array.
managed is TRUE if the new widget should be managed when created, FALSE
otherwise.
The OlCreatePackedWidgetList() is passed a pointer to an OlPackedWidget
array and the number of elements in the array. It creates widgets
starting from the first element in the array, and returns the ID of the
topmost widget.
Page 2 10/89