Skip to main content
Version: 7.9

Text Area

Component Palette Icon

Suitable for multi-line text display and editing. Will scroll vertically on demand. Will scroll horizontally if line wrap is off. Only supports plain-text, no HTML formatting or styled text.


New in 7.9.5
Some of the following properties are new.

NameDescriptionProperty TypeScriptingCategory
AntialiasDraw with antialias on? Makes text smoother.boolean.antialiasAppearance
Background ColorThe background color of the component.Color.backgroundAppearance
BorderThe border surrounding this component. NOTE that the border is unaffected by rotation.Border.borderCommon
ColumnsThe number of columns you expect to display (used as a hint for scrollbars).int.columnsAppearance
CursorThe mouse cursor to use when hovering over this
Data QualityThe data quality code for any tag bindings on this
Defer UpdatesWhen true, the 'text' property will not fire updates while typing. It will wait for the component to lose focus.boolean.deferUpdatesBehavior
EditableControls whether or not the user can edit the text within this text area.boolean.editableBehavior
EnabledIf disabled, a component cannot be used.boolean.componentEnabledCommon
FontFont of text on this component.Font.fontAppearance
Foreground ColorThe foreground color of the component.Color.foregroundAppearance
Line WrapShould this area wrap lines?boolean.lineWrapBehavior
Mouseover TextThe text that is displayed in the tooltip which pops up on mouseover of this component.String.toolTipTextCommon
NameThe name of this component.String.nameCommon
Reject Updates During EditIf true, this field will not accept updates from external sources (like DB bindings) while the user is editing the field.boolean.rejectUpdatesDuringEditBehavior
RowsThe number of rows you expect to display (used as a hint for scrollbars).int.rowsAppearance
StylesContains the component's styles.Dataset.stylesAppearance
Tab SizeThis adjusts the default size of tab
TextText of this component.String.textData
Touchscreen ModeControls when this input component responds if touchscreen mode is
VisibleIf disabled, the component will be hidden.boolean.visibleCommon


Scripting Functions

This component does not have scripting functions associated with it.

Extension Functions

This component does not have extension functions associated with it.

Event Handlers

Event handlers allow you to run a script based off specific triggers. See the full list of available event handlers on the Component Events page



Word Wrap and No Scroll Bars until Needed

Property NameValue
Line WrapTrue
Text514 Characters