DriveWorks Pro 24

Text Box

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.

• Opacity

  Specifies the opacity of the control.

  Requires a value between 0 (not visible) and 100 (fully visible).

Appearance - Border

• 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.

• Show Border

  Specifies whether or not to show the border for this control.

Appearance - Caption

• Caption

  Controls the control's caption.

  The text displayed in this property can have formatting tags applied to decorate parts of the text string, see Formatting the Displayed Text below for more information.

• 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

Behavior

• Character Limit

  Limits the number of characters that can be entered in the control. If set to 0, any number of characters can be entered.

• Default Value

  Controls the default value of the control. If the default value is based on a rule and the value changes, then the value of the control will be changed to be the new default value.

• 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 value that can be selected on the control.

• Minimum

  The minimum value that can be selected on the control.

• Multiline

  Specifies whether the text box is multi-line (TRUE) or single line (FALSE).

• Read only

  Prevents the text from being edited but still allows for text selection and scrolling.

• Tab Index

  Configures the position of the control in the form tab order.

• Text

  Specifies the text shown in the control.

• Text (Override Rule)

  Specifies the text shown in the control.

• Visible

  Determines whether the control is visible (TRUE) or hidden (FALSE).

Events

• Macro Argument

  Provides an optional argument to the macro

• On Change

  Determines the name of the macro to fire when the value of this control changes.

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.

  The text displayed in this property can have formatting tags applied to decorate parts of the text string, see Formatting the Displayed Text below for more information.

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.

Convert Text Box to Measurement Text Box

Any Text Box control added to a user form can be converted to a Measurement Text Box control.

1. In Form Design, right click on the Text Box control to be converted.
2. Select Convert > To MeasurementTextBox

   

3. The Text Box will convert to a Measurement Text Box.

   All properties common to both controls will be retained.

If the original Text Box is required to be reinstated, use the Undo button from the command bar (or the keyboard shortcut Ctrl + Z)

Formatting Text

The text displayed in the Caption and Tooltip Text property support the use of formatting tags to format parts of the text string.

The supported tags are:

• Bold
• Italic
• Underline
• Color
• Url (not supported for Tooltip Text)

See How To: Format Text for more information.

MyDriveWorks - Tech Tips

Default Value Rule

This Project demonstrates the differences between the Default Value and Override Value properties on your Controls.

Tech Tips Index

View all available MyDriveWorks Tech Tips.

DriveWorks Tech Tips Index