Measurement Text Box (DriveWorks Documentation)

Measurement Text Box

The Measurement Text Box displays a box in which numeric values can be entered with the ability to select which units the value is displayed in.

Changing the display units once a value has been entered will recalculate the displayed value based on the conversion between the units.

When the form control is applied the name entered will display as the caption for the form control. This can be changed by selecting the Caption property.

Properties

Appearance

Background Color
Specifies the color of the control's background.
Input Background Color
Specifies the background color of the control's input area.
Input Background Color (Disabled)
Specifies the background color of the control's input area when the control is disabled.
Input Background Color (FOCUS)
Specifies the background color of the control's input area when in a focused state.
Input Background Color (Hover)
Specifies the background color of the control's input area when in a hovered state.
Input Opacity (Disabled)
Specifies the opacity of the control's input area when the control is disabled, between 0 and 100.
Input Padding
Specifies the padding of the control's input area.
Input Spacing
Specifies the spacing between inputs in the control.
Unit Background Color
Specifies the background color of the unit select.
Unit Background Color (Disabled)
Specifies the background color of the unit select when the control is disabled.
Unit Background Color (Hover)
Specifies the background color of the unit select when in a hovered state.
Unit Icon Color
Specifies the color of the icon in the unit select.
Unit Icon Color (Disabled)
Specifies the color of the icon in the unit select when the control is disabled.
Unit Icon Color (Hover)
Specifies the color of the icon in the unit select when in a hovered state.
Unit Padding
Specifies the padding of the unit select.

Appearance - Border

Border Radius
Specifies the border radius of the control.
Input Border Color
Specifies the border color of the control's input area.
Input Border Color (Disabled)
Specifies the border color of the control's input area when the control is disabled.
Input Border Color (Focus)
Specifies the border color of the control's input area when in a focused state.
Input Border Color (Hover)
Specifies the border color of the control's input area when in a hovered state.
Input Border Radius
Specifies the border radius of the control's input area.
Input Border Width
Specifies the border width of the control's input area.
Input Outline Color (Focus)
Specifies the outline color of the control's input area when in a focused state.
Unit Border Color
Specifies the border color of the unit select.
Unit Border Color (Disabled)
Specifies the border color of the control's input area when the control is disabled.
Unit Border Color (Focus)
Specifies the border color of the unit select when in a focused state.
Unit Border Color (Hover)
Specifies the border color of the unit select when in a hovered state.
Unit Border Radius
Specifies the border radius of inputs in the control. If the value is blank, "Border Radius" will be applied.
Unit Border Width
Specifies the border width of the unit select.
Unit Outline Color (Focus)
Specifies the outline color of the unit select when in a focused state.

Appearance - Caption

Caption
Controls the control's caption.
Caption Color
Controls the caption color of the control.
Caption Font
Determines the font used for the controls caption.
Caption Horizontal Alignment
Controls whether the text inside the caption is horizontally aligned to the left, right or center

Appearance - Text

Font
Specifies the font of the text shown in the control.
Text Color
Specifies the color of the control's text.
Text Color (Disabled)
Specifies the color of the control's text when the control is disabled.
Text Color (Focus)
Specifies the color of the control's text when the control is in a focused state.
Text Color (Hover)
Specifies the color of the control's text when the control is in a hovered state.
Text Horizontal Alignment
Controls whether the text is horizontally aligned to the left, right or center
Unit Font
Specifies the font used in the unit select.
Unit Text Color
Specifies the text color of the unit select.
Unit Text Color (Disabled)
Specifies the text color of the unit select when the control is disabled.
Unit Text Color (Hover)
Specifies the text color of the unit select when in a hovered state.

Behavior

Decimal Places
Controls the number of decimal places shown in the control. If the value is set to a negative value, DriveWorks automatically determines the required number of decimal places.
Display Units
Determines the unit of measurement used to display the value of the control.
Display Value
Provides access to the value of the control, expressed in display units.
Enabled
Controls whether the control is enabled (if the result is TRUE) or disabled (if the result is anything other than TRUE, e.g. FALSE).
Error Result
Determines whether the value of the control is in error. The result of this rule is a string containing the error message if the value is in error, otherwise a blank string or the number zero.
Maximum
The maximum date that can be selected on the control.
Minimum
The minimum date that can be selected on the control.
Native Units
Determines the unit of measurement used when storing the control's value.
Tab Index
Configures the position of the control in the form tab order.
Visible
Determines whether the control is visible (TRUE) or hidden (FALSE).

General

(Metadata)
Optional text which can be used to provide information belonging to or about a control. For example, a list of CSS classes which can be parsed and applied to the control using the Integration Theme in DriveWorks Live. This doesn't affect the control's behavior.
(Name)
The name of the control
(Tag)
Optional text which can be used to describe the control, but which doesn't affect the control's behavior.
Tooltip Duration
Controls the duration, in seconds, for which the tooltip will remain visible. Values of 0 and below indicate an infinite duration.
Tooltip Text
Specifies the text to display in a tooltip when hovering over the control.

Layout

Caption Width
Controls the width of the control's caption.
Height
Controls the height of the control.
Left
Controls the left position of the control.
Top
Controls the top position of the control.
Width
Controls the width of the control.

A user form control that accepts numeric values and gives a choice of units for the value entered. Automatic conversion between units is supported and mathematical expressions can be used in the control.

DriveWorks Pro 22 Measurement Text Box