Work Area: _setWidgets

Work Area: _setWidgets

Replaces the current work area items with new items

Syntax
Details
See Also

Syntax

CALL NOTIFY (workarea-name, '_setWidgets', widget-list<, 'PUSH'>);

Argument Type Description

widget-list
N specifies the identifier of an SCL list containing descriptive information about the new work area items. The list is expected to be in the form returned by the _getWidgets method.

'PUSH' C saves the current list of work area items so it can be restored by the _popWidgets method

Argument	Type	Description
widget-list	N	specifies the identifier of an SCL list containing descriptive information about the new work area items. The list is expected to be in the form returned by the _getWidgets method.
'PUSH'	C	saves the current list of work area items so it can be restored by the _popWidgets method

Details

The work area is saved as an SCL list in a catalog entry of type WORKAREA. Because this is the same format as _afWORKAREA, you can reload the saved work area with the _setWorkarea method. For more information about _afWORKAREA, see Using the Work Area Class.

_setWidgets redefines the layout of the work area by replacing the existing list of work area items with the new list of items defined in widget-list. You can use this method to dynamically set the list of work area items that are displayed in the work area at run time.

You can pass the entire contents of a work area to the _setWidgets method by using the FILLIST function to create the list of work area items.

However, the list of information does not have to be complete. If the _classname list item is present in each item's sublist, a work area item is created and the defaults for the class replace any missing list items. (_classname is the two-level class name within the work area's resource.) If no region position information is passed in, an automatic placement is chosen.

See Also

_getWidgets in the Frame class.

Chapter Contents
Previous
Next
Top of Page