| Reference > TDBNumLite Control > TDBNumLite Control Properties > Text Property (TDBNumLite) |
Text Property (TDBNumLite)
Sets/returns the text of the control.
TDBNumLite.Text= string
Read/Write at run time and design time.
The Text property allows you to return or set an exact matching numeric value in text format depending on the negative format specified with the MinusSign property. For example:
TDBNumLite.MinusSign = dbiParenthesesAsMinus
TDBNumLite.Text = "(12345.12)"
With the example above, the Value property will return -12345.12. However, if you set a text string such as "-12345.12", an invalid value error will occur, since the text does not match the current negative format.
When setting the Text property to a zero-length string the underlying value will be set to Null regardless to the ClearAction setting. Setting a "0" text string will set the underlying value to zero.
When modifying numeric values that are not within the proper range by changing the Value or the Text property, you will cause an invalid value range error to occur without any events firing. If an invalid value is set into these properties, an invalid value error will occur.
When the Text property is changed, the changes will also be reflected in the Value property.
The number of digits set in the Text property should not exceed fifteen digits including both the integer and the decimal places. The integer digit count will vary depending on the number of decimal digits being used.
See Also