Release 10.1A: OpenEdge Development:
ADM Reference

> ## enableWidget

> Enables the object or objects identified in the name list. For SmartDataFields, it runs the enableField function. Note that enableField is not a generic SmartDataField function, therefore this API is only supported for SmartDataFields that have enableField defined. If a field in the list is not found, or a SmartDataField without enableField is included in the list, enableWidget 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 added to the EnabledFields and EnabledHandles properties to ensure that once the field is enabled by the API, it remains so enabled.

> - Local fields are added to the EnabledObjFldsToDisable property when the property is not set to (None) or (All). This action ensures that once a field is enabled by the API, it remains enabled. It could also result in adding a field that was not included in the EnabledObjFldsToDisable property initially to the property by a call to this API. If this behavior is not desired, do not use the enableWidget function or manipulate the EnabledObjFldsToDisable property after using the function to remove the field.

> Examples:

> The following illustrates the use of this method in 4GL code for use with a graphical user interface:

>     IF widgetIsModified("customerviewv.discount":U) THEN
>      enableWidget("Self.terms":U).

> The following illustrates the use of this method in DHTML code for use with a Web browser:

>     if (logic.widgetIsModified(‘customerviewv.discount’))
>       logic.enableWidget(‘orderviewv.terms’);

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