How To Tutorials

How to Use Dynamic Control Properties

Using Dynamic control properties in your application is an effective way to speed up new development. More importantly, when future enhancements are needed, integrating these changes into your application will be easier and less disruptive.

Dynamic control properties can be created for Multi-Lines, Drop Boxes, List Boxes and Check Boxes. When combined with data classes, dynamic control properties are ideally suited for data elements with similar properties in an application (i.e. dates, numeric codes, descriptions or lists of values).

How to Create Dynamic Control Properties

These steps show you how to create dynamic control properties in combination with data classes.

1.

From the IDE Main Launcher, expand the Data Management category, and select Data Class Definitions. The Data Class Definitions window is displayed.

2.

Begin creating a dynamic data class. Enter the Class Name and then select the Control Type. Dynamic data classes can be defined for Multi-Lines, Drop Boxes, List Boxes and Check Boxes, but not for Radio Buttons.

3.

The Dynamic check box must be selected to define this as a dynamic data class.

4.

Enter the desired properties. The dynamic properties for each data class are identified with an * (asterisk).

5.

Click the Write button. When the data class is saved, it is automatically created as dynamic.

6.

Once the dynamic data class has been created, it can be applied to the appropriate control(s). In the NOMADS Panel Designer, open the panel(s) and access the properties for the specific control. For the Class field, enter the name of the dynamic data class or use the Query button (binoculars) to select it.

Note:
You can only select a data class that is specific to that control type; i.e. Multi-Line data classes can only be applied to Multi-Line controls.

7.

All the information from the dynamic data class just entered will be copied to the control. In addition, certain control properties are created as dynamic automatically, as indicated by the Dynamic setting and by the %nomads'classfield object property, which is locked.

Note:
The settings for individual dynamic properties can be overridden at any time for each control.

8.

At run time, the values for the dynamic control properties will be rendered based on the contents of the data class. Once the data class is entered for the control, future changes are only required at the data class level.

How to Convert Non-Dynamic Data Classes and Controls to Dynamic Properties

These steps show you how to convert non-dynamic data classes and controls to dynamic properties. This is useful if you have non-dynamic data classes (where the Dynamic check box is not selected) assigned to specific controls and you want to set the dynamic properties.

1.

Open the Data Class Definitions window. Bring up the non-dynamic data class either by entering the Class Name or by using the Query button (binoculars) to select it.

2.

Select the Dynamic check box. Make any additional modifications as required.

3.

Click the Write button to save. The data class is now defined as dynamic.

4.

In the NOMADS Panel Designer, open the panel(s) and access the properties for the specific control that has this data class. The Dynamic Class check box is selected.

5.

To make the control dynamic, click the Reapply Data Class button (left/right circular pointing arrows) beside the Class field.

    

6.

A message is displayed, asking if you want to continue. Respond Yes to copy the current information from the data class to the control properties and make the appropriate properties dynamic.

Note:
This process of converting controls to dynamic can also be done by using the Library Bulk Edit and Search utility.

See Also

Dynamic Control Properties