Drop-Down

Name

Yes

Writable

Readable

To set the property

control.findById("ID").tagName = "Value for Name";

To get the value of the property

control.findById("ID").tagName;

XML Node

Yes

Readable

To get the value of the property

control.findById("ID").xmlNodeBoundTo;

Description

Yes

Writable

Readable

To set the property

control.findById("ID").description = "Value for Description";

To get the value of the property

control.findById("ID").description;

Tooltip

No

Not Applicable

Options Caption

Yes

Writable

Readable

To set the property

control.findById("ID").optionCaption = "Value for Options Caption";

To get the value of the property

control.findById("ID").optionCaption;

Options

No

Not Applicable

Default Value

Yes

Readable

To get the value of the property

control.findById("ID").defaultValue;

Enable

Yes

Writable

Readable

To set the property

control.findById("ID").enable = true;

To get the value of the property

control.findById("ID").enable;

Visible

Yes

Writable

Readable

To set the property

control.findById("ID").visible = true;

To get the value of the property

control.findById("ID").visible;

Label Position

No

Not Applicable

Label-Control Area

No

Not Applicable

Width

No

Not Applicable

Retain Space

No

Not Applicable

Custom Style Sheet Identifier

No

Not Applicable

Mandatory

Yes

Writable

Readable

To set the property

control.findById("ID").isMandatory = true;

To get the value of the property

control.findById("ID").isMandatory;

On Data Change

Yes

For more information, see scripting guidelines for On Data Change property.

Note: If you use scripts for On Data Change property of a Drop-Down control to add a record to a Base Form, then the focus will be on the first control of the Base Form.

ID

No

Not Applicable

Text Parameter

Yes

Writable

Readable

To set the property

control.findById("ID").optionText = "OText";

To get the value of the property

control.findById("ID").optionText;

Value Parameter

Yes

Writable

Readable

To set the property

control.findById("ID").optionValue = "OValue";

To get the value of the property

control.findById("ID").optionValue;

Include in Summary

No

Not Applicable

Name

Yes

return "Value for Name";

Description

Yes

return "Value for Description";

Enable

Yes

return true;

For more information, see scripting guidelines for Enable property.

Visible

Yes

return true;

For more information, see scripting guidelines for Visible property.

Mandatory

Yes

return true;

For more information, see scripting guidelines for Mandatory property.

Default Value

Yes

return "ValueOne";

OR

return "ValueOne;#ValueTwo;#ValueThree";

Note:
- If the value is not one of the values set for the Value parameter in the Options property, then that value will not be a part of the options but will be a part of the XML instance.
- Multiple values must be separated with ;#
- The Value script takes precedence over the Default Value script.

Value

Yes

return "ValueOne";

OR

return "ValueOne;#ValueTwo;#ValueThree";

Validate

Yes

return new ValidationOptions(false, "Error Message");

OR

return new ValidationOptions(true, "");

For more information, see scripting guidelines for Validate property.

Options

Yes

return "[{\"OValue\":\"1\",\"OText\":\"ValueOne\" },{\"OValue\":\"2\",\"OText\":\"ValueTwo\"},{\"OValue\":\"3\",\"OText\":\"ValueThree\"}]";

Here OText is the Text Parameter and OValue is the Value Parameter.

For more information, see scripting guidelines for Options property.

Note:
-Text Parameter and Value Parameter properties must be specified before using the Options property script.
-Fore Color and Back Color properties cannot be set through scripts.