Home Search

DriveWorks Pro 24
How To: Reference Control Properties (KB16010601)

Send Feedback

How To: Reference Control Properties

There are two types of control property. These can be categorized into how the property is referenced (when used in a rule).

  • Direct Reference
  • Hierarchical Reference

The difference between the two is in how the property is referenced.

Applying the MyName() function directly on these properties will return the property reference.

Direct Referencing

The control properties that are most commonly used in rules can be referenced directly from the rules builder.

When the property is selected the control name is given a prefix that corresponds to the property.

The table below shows the available direct referenced properties and their prefixes:

Property ReferenceTypeExample Return Value
ControlNameEnabledBooleanTrue
ControlNameErrorNumeric4
ControlNameListDataStringOption A|Option B|Option C
ControlNameMaxNumeric32500
ControlNameMinNumeric17500
ControlNameReturnBy control typeReturns the current value of the control as entered on the user form
ControlNameVisibleBooleanTrue

Hierarchical Referencing

For all other control properties a hierarchical reference is used when the property value is required in a rule.

These properties can be selected from the rules builder intellisense or typed into the rule editor.

Hierarchical properties require a point separator between the control name and the property, for example:

ControlName.PropertyName

For example, to obtain the value of the height property of a control named ProductOptions, the reference used in the rule would be:

ProductOptions.height

Property Name

The property name is referenced using the name as displayed in the property list of the form designer, with all spaces and parentheses removed.

For example, the property:

  • List Item Border Radius

    is referenced by:

    ControlName.ListItemBorderRadius

    A property that uses parentheses is referenced by:

  • Input Border Color (Hover)

    is referenced by

    ControlName.InputBorderColorHover


Knowledge Base Article Ref:KB16010601