LIST-WIDGETS function

Returns a comma-separated list of objects and widget types that respond to a specified event.

Note: Does not apply to SpeedScript programming.

Syntax

LIST-WIDGETS ( event-name [ , platform ] )
event-name
A character-string expression that evaluates to an event name.
platform
A character-string value that specifies a display type. Valid values are GUI and TTY. Some events are valid only on certain platforms. If you omit the platform parameter, the AVM uses the platform for the current session.

Example

The following example prompts for an event name and then displays a list of widget types that support that event:

r-lwids.p

DEFINE VARIABLE event-name  AS CHARACTER NO-UNDO FORMAT "x(24)" 
  LABEL "Event".
DEFINE VARIABLE widget-list AS CHARACTER NO-UNDO LABEL "Widgets"
  VIEW-AS SELECTION-LIST INNER-CHARS 24 INNER-LINES 6 SCROLLBAR-VERTICAL.

FORM event-name SKIP widget-list
  WITH FRAME main-frame SIDE-LABELS.

REPEAT WITH FRAME main-frame:
  DISABLE widget-list.
  SET event-name.
  widget-list:LIST-ITEMS = LIST-WIDGETS(event-name).
  DISPLAY widget-list.
  ENABLE widget-list.
  PAUSE.
END.

See also

LAST-EVENT system handle, LIST-EVENTS function, LIST-QUERY-ATTRS function, LIST-SET-ATTRS function, VALID-EVENT function