Accessors for class IliDbText

Properties

Description

The IliDbText class defines a text gadget that can be connected to a data source.
A DbText can be connected to a data source's column. Whenever the value of this column changes in the data source, the DbText's value property is updated accordingly.
A DbText has both a value property and a text property. The text, inherited from the IlvText class, contains a character string representation of the value. So, for instance, if the value is set to the integer 10, the label will become the character string "10".
The end user can edit the text through the DbText gadget. In this case, the value can become temporarily out of synch with the label. The data source to which the DbText is connected will detect that the input has been modified, parse the label to produce a corresponding value, and store it both in the data source's column and in the DbText's value property.

TypeNameDescriptionNotes
StringcolumnNameContains the column name that the gadget must connect to. The column name must designate a valid column of the data source.
IliDataSourcedataSourceContains the data source object. This property cannot be written to if the dataSourceName property is not empty. In other words, the data source can be specified either literally through the dataSource property or by name through the dataSourceName property, but not both.
StringdataSourceNameContains the data source name.
BooleaninputModifiedThis property is true if the textual representation has been edited by the end user.read-only
BooleanreadOnlyThis property is true if the gadget is read-only.
StringtablePropertyManagerNameContains the name of the table property manager used by this gadget or null if the data source's table property manager is used. Initially, this property is null.
BooleanuseTablePropertiesContains true if the gadget uses table properties. Note that the gadget will effectively use table properties if this property is true and if the data source to which it is connected is also using table properties. Initially, this property is true.
VariantvalueContains the value of the DbText. The type of this property depends on the column's data type.
DatatypevalueTypeContains the data type of the value. Its string representation can be one of the following:
  • String

  • Integer

  • Boolean

  • Double

  • Float

  • Decimal

  • Date

  • Time

Although this property is not read-only, it should not be assigned if the DbText is connected to a data source.