Progress
Language Reference


LIST-WIDGETS Function

Interfaces
OS
SpeedScript
All
All
No

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

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, Progress 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 FORMAT "x(24)" LABEL "Event".
DEFINE VARIABLE widget-list AS CHARACTER 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


Copyright © 2004 Progress Software Corporation
www.progress.com
Voice: (781) 280-4000
Fax: (781) 280-4095