Progress
Language Reference
DISABLE Statement
Disables input for one or more field-level and child frame widgets within a frame that were previously enabled with the ENABLE statement. Disabling a widget prevents the user from providing input to the widget, but does not remove it from the display.
SYNTAX
UNLESS-HIDDEN
Restricts DISABLE to fields whose HIDDEN attribute is FALSE.
ALL [ EXCEPT field ... ]
Specifies that all field-level widgets for a frame should be disabled, except those that you optionally specify.
field [ WHEN expression ]
A field-level widget to be disabled. If you use the WHEN option, then the field is disabled only if expression is TRUE when the DISABLE statement is executed. The expression must evaluate to a LOGICAL value.
frame-phrase
The frame that contains the widgets to disable. If you omit frame-phrase, the default frame for the current block is assumed.
You cannot use the IN WINDOW option of the frame phrase within a DISABLE statement. For more information on frame-phrase, see the Frame Phrase reference entry.
EXAMPLEIn the following example, the cust-num field and the Quit button are initially active. When you press GO in the cust-num field, that field becomes disabled and the Save and Undo buttons and the credit-limit field are enabled. If you choose either the Save or Undo button, those buttons and the credit-limit field are again disabled and the cust-num field is enabled again.
NOTE
If you invoke the DISABLE statement for the parent frame of a frame family, the field representation widgets and descendant frames owned by the parent frame are all disabled. However, the field representation widgets of the descendant frames remain enabled and appear sensitive, although they cannot accept input. To disable field representation widgets in the descendant frames and make them appear insensitive, you must invoke DISABLE statements for each of the descendant frames.
SEE ALSO
Copyright © 2004 Progress Software Corporation www.progress.com Voice: (781) 280-4000 Fax: (781) 280-4095 |