| Reference > TDBMask Control > TDBMask Control Properties > Text Property (TDBMask) |
Text Property (TDBMask)
Returns or sets the text, including any literals in the control.
TDBMask.Text= string
Read/Write at run time and design time.
The Text property allows you to return or set an exact matching text string including all literals specified with the Format property. If not, the text string will be treated as an error.
If the Value property is set to a zero-length string, the Text property will return a string including all literals and the prompt character or a text string based on the 2nd pattern (Empty) specified in the input mask. In the case above, the Text property will return a zero-length string.
When the Text property is changed, the changes will also be reflected in the Value property.
The return value for the Text and the DisplayText property can differentiate only when the Empty patterns (format when the control has the focus and without the focus) specified in the Format property are not the same and with the underlying value set to a zero-length string.
Applying a zero length string to the Text property will automatically clear the underlying text and rebuild a string using the prompt character with all literals defined in the input mask for the Text property.
See Also