Progress
Language Reference
CREATE Widget Statement
Creates a dynamic object, such as a widget object.
SYNTAX
VALUE ( string-expression )
An expression of type CHARACTER that evaluates to the type of object you want to create (for example, BUTTON) with any combination of uppercase and lowercase characters.
widget-handle
A variable of type WIDGET-HANDLE that Progress sets to the value of the new widget handle.
IN WIDGET-POOL pool-name
Specifies the widget pool in which the object is created. If you do not specify a widget pool, the object is created in the current default widget pool.
ASSIGN { attribute = expression } ...
Assigns specified values to attributes of the object. The attribute parameter must be the name of a valid attribute for the object and expression must evaluate to a valid value for that attribute.
trigger-phrase
A trigger phrase associated with the object. For more information, see the Trigger Phrase reference entry.
EXAMPLEThis procedure creates a dynamic button that displays a list of customer names.
NOTES
- Attribute assignments you specify in the CREATE Widget statement are processed in the order they appear. In some cases you must supply the attributes in proper order. For example, you cannot set the SENSITIVE or VISIBLE attributes for a field-level widget until you have set its FRAME attribute.
- If you are setting the FORMAT attribute and specifying an initial SCREEN-VALUE for the widget, assign the FORMAT before the SCREEN-VALUE. Otherwise, the default format is applied to the SCREEN-VALUE which might cause truncation or other formatting errors.
- If you create a frame to use as a DDE frame, you must realize the frame (set its VISIBLE attribute to TRUE) before using it as a conversation end-point. If you want the DDE frame to remain invisible during its use in a DDE conversation, set its HIDDEN attribute to TRUE after realizing the frame. For information on DDE frames, see the Progress External Program Interfaces manual.
SEE ALSO
CREATE QUERY Statement, CREATE WIDGET-POOL Statement, DEFINE FRAME Statement, DELETE WIDGET Statement, DELETE WIDGET-POOL Statement, Trigger Phrase
Copyright © 2004 Progress Software Corporation www.progress.com Voice: (781) 280-4000 Fax: (781) 280-4095 |