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.

name    is 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.

resources

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

num_resources

is the number of resources in the array.

managed is TRUE if the new widget  should  be  managed  when
        created, FALSE otherwise.  The OlCreatePackedWidget-
        List() 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.