NAME

OlCreatePackedWidgetList, OlPackedWidget − routines to create a widget (sub)tree in one call

SYNOPSIS

#include <X11/Intrinsic.h>
#include <X11/StringDefs.h>
#include <Xol/OpenLook.h>
 . . .
Widget OlCreatePackedWidgetList(

OlPackedWidgetList ∗pw_list,
register Cardinal num_pw);

DESCRIPTION

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

Version 3.0.1  —  Last change: February 92