PACKED WIDGETS(3W)MISC. REFERENCE MANUAL PAGES PACKED WIDGETS(3W)
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 OlCreatePack-
edWidgetList() 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 Pack-
edWidget 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
Amiga Unix Last change: 1
PACKED WIDGETS(3W)MISC. REFERENCE MANUAL PAGES PACKED WIDGETS(3W)
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.
Amiga Unix Last change: 2