Multi-line Text Box Properties

 

A multi-line text box provides a control for the user to input multi-line text, such as comments. When the text reaches the end of a line it wraps down to the next line.

Appearance

 

Alignment

This property determines the positioning of the text in the multi-line text box:

  • Auto - text is aligned based on the field type of the assigned field ID.
  • Left - text is left-aligned.
  • Right - text is right-aligned.

BackColor

The background color that displays inside the multi-line text box. Choose from web, system, or custom colors.

Font

Refers to a type family. Controls the appearance of the text displayed in the multi-line text box including size, bold, italic, and underline.

ForeColor

The color of the text displayed in the multi-line text box. Choose from web, system, or custom colors.

HelpKey

An index into the Help system to provide default hover text for the field. This property is typically the same as the field ID. Controls on standard Encompass360 forms are all assigned with HelpKey values. Based on this property, appropriate hover text is associated with the control. Custom fields need an original HelpKey.

HoverText

The text that appears when the user hovers the mouse pointer over the field. This text overrides the default text referenced by the HelpKey property.

Behavior

 

Enabled

Sets the initial state of the multi-line text box as enabled (True) or disabled (False). If set to False, the multi-line text box is dimmed.

Visible

If set to True, the multi-line text box is visible on the form. If False, the multi-line text box is not visible.

Border

 

BorderColor

The color of the border that displays around the multi-line text box. Choose from web, system, or custom colors.

BorderStyle

Controls the style of the border around the multi-line text box. Typically, the Inset style is preferred.

BorderWidth

Controls the width of the border (in pixels).

Control

 

ControlID

Used to identify the control. For example, the first multi-line text box on the form will be assigned the control ID MultilineTextBox1 while the next multi-line text box is assigned MultilineTextBox2. You can change the control ID as needed. The ID can contain numerals or letters, but it must begin with a letter.

Data

 

Field

The Encompass360 field ID associated with the multi-line text box field.

Note: Custom field IDs created from this property are assigned to the selected control.

Layout

 

Position

Controls the relative position (in pixels) of the multi-line text box on the form. The X value determines left to right, the Y value determines top to bottom position. Click the Position property and type values or expand the row to view the X and Y properties and make your changes.

Size

Controls the width and height of the multi-line text box (in pixels). Click the Size property and type values or expand the row to view the Width and Height properties and make your changes.

TabIndex

Determines the tab order of the multi-line text boxes on the form. To keep a multi-line text box out of the tab order, set the TabIndex to -1.

Rolodex

 

Rolodex

The control ID of the Rolodex control associated with the multi-line text box.

RolodexField

The field populated from the Rolodex.