Kbase P82789: Dynamics. How to disable fields of a dynamic viewer.
Autor |
  Progress Software Corporation - Progress |
Acesso |
  Público |
Publicação |
  6/2/2004 |
|
Status: Unverified
GOAL:
Dynamics. How to disable fields of a dynamic viewer.
FACT(s) (Environment):
Dynamics 2.1A
FIX:
disableWidget
Disables the object or objects identified in the namelist.
For SmartDataFields, it runs the disableField function. disableField is not a generic SmartDataField function, therefore this API is only supported for SmartDataFields that have disableField defined. If a field in the list is not found, or a SmartDataField without disableField is included in the list, disableWidget returns FALSE.
Location: visual.p
Parameters:
INPUT namelist AS CHARACTER
The name of one or more objects, separated by commas.
Returns: LOGICAL
Notes:
? Data fields are removed from the EnabledFields and EnabledHandles properties to ensure that once the field is disabled by the API, it remains disabled,
? Local fields are removed from the EnabledObjFldsToDisable property when the property is set to a field list. When the EnabledObjFldsToDisable property is set to (All), the disableWidget function sets this property to the value of the EnabledObjFlds property without the field being disabled. This action ensures that once a field is disabled by the
API, it remains disabled. When the EnabledObjFldsToDisable property is set to (None), it is not changed.
Examples:
The following illustrates the use of this method in 4GL code for use with a graphical user interface:
The following illustrates the use of this method in DHTML code for use with a Web browser:
IF widgetValue("Browse.Terms":U) NE "":U THEN disableWidget("Self.Discount":U).
if (logic.widgetValue(?orderfullo.browse.terms?)!=??)
logic.disableWidget(?customerviewv.discount?);