SYNOPSIS

#include <Intrinsic.h>
#include <StringDefs.h>
#include <OpenLook.h>

typedef struct {
        Widget widget_returned;
        String name;
        WidgetClass ∗class_ptr;
        Widget ∗parent_ptr;
        String descendant;
        ArgList resources;
        Cardinal num_resources;
        Boolean managed;
} OlPackedWidget;

Widget = OlCreatePackedWidgetList(pw_list, num_pw)
OlPackedWidget ∗pw_list;
Cardinal num_pw;

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 pw_list.  Each element in this array is of the type OlPackedWidget.  This structure gives all the information needed to create a new widget:

widget_returned
will contain the ID of the newly created widget.

nameis the name of the widget that will be created. 

class_ptr
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. 

parent_ptr
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, it must appear earlier in the list. 

descendant
is the name of a resource available in the widget identified by parent_ptr.  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. 

resourcesis the resource array to use when creating the new widget. 

num_resources
is the number of resources in the array.

managedis 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. 

Sun Release 4.0  —  Last change: 1/8/90