| The Text Box component offers a program a facility to display
a variable value, and offers an end-user a facility to enter
a value. Clich here for an overview of the differences and similarities between the various components that provide selection list and input box capabilities. |
If the property "display only" is set to true, it will not be possible for the end-user to modify the value in the text box. The program, however, may still make modifications to the value, and re-display its new value.
The events that are recognized for components of the type TextBox are: Create, Destroy, Enter, Exit, Modified, change, char, gotFocus, help, keyDown, keyUp and lostFocus.
The default property for a text box is Value.
The property list for a text box is:
| Property Name (MSM-Workstation) | Property Name (MWAPI) | Default Value | Value Range |
|---|---|---|---|
| Active | ACTIVE | Boolean value | |
| BackColor | BCOLOR | Color | |
| Border | FRAMED | 1 | Boolean value |
| Cancel | CANCEL | Boolean value | |
| Changed | CHANGED | Boolean value | |
| Container | Free text | ||
| DataField | Field | ||
| DispFmtParams | |||
| DispFmtType | |||
| DisplayOnly | CANCHANGE | Boolean value | |
| FontBold | FSTYLE | Boolean value | |
| FontFace | FFACE | Font face | |
| FontItalic | FSTYLE | Boolean value | |
| FontSize | FSIZE | Font size | |
| FontUline | FSTYLE | Boolean value | |
| ForeColor | FCOLOR | Color | |
| MaxLength | CHARMAX | Positive integer numeric value | |
| Message | ZMESSAGE | Free text | |
| Name | Name of component (current window) | ||
| NextControl | NEXTG | Name of component | |
| PasswordChar | ZPASSWORDCHAR | Password character | |
| Pointer | PTYPE | Pointer (extended) | |
| PosLeft | POS | Positive numeric value | |
| PosTop | POS | Positive numeric value | |
| PosUnits | POS | Unit Specification | |
| SelStartLength | INSELECT | Selection | |
| SizeHeight | SIZE | 10 | Positive numeric value |
| SizeUnits | SIZE | Unit Specification | |
| SizeWidth | SIZE | 40 | Positive numeric value |
| TBackColor | TBCOLOR | Color | |
| TFontBold | TFSTYLE | Boolean value | |
| TFontFace | TFFACE | Font face | |
| TFontItalic | TFSTYLE | Boolean value | |
| TFontSize | TFSIZE | Font size | |
| TFontUline | TFSTYLE | Boolean value | |
| TForeColor | TFCOLOR | Color | |
| Title | TITLE | [Title] | Free text |
| TitlePos | TPOS | Title position | |
| Type | TYPE | TEXT | Type of component |
| Units | UNITS | Unit Specification | |
| ValidateParams | |||
| ValidateType | |||
| Value | VALUE | Free text | |
| VarName | Name of variable | ||
| VarPermanent | Boolean value | ||
| Visible | VISIBLE | Boolean value | |
Go back to the alphabetic list of components.