Accessors for class IliTableComboBox

Properties

• allowEdit
• arrowShown
• autoFitting
• completion
• constrained
• foreignDataSourceName
• foreignDisplayColumnName
• foreignTable
• foreignValueColumnName
• pullDownWidth
• tableColumns
• tablePropertyManagerName
• useTableProperties
• visibleRowsCount

Callbacks

• Close
• Open

Description

• Create a data source named "MAP" with two columns:

  column name: "VALUE", type: Integer

  column name: "DISPLAY", type: String

• Enter the following rows into this data source:

       0, "No"
       1, "Yes"
       2, "Maybe"
  
  

• Set up the gadget as follows:

       tblcombo.foreignDataSourceName    = "MAP";
       tblcombo.foreignDisplayColumnName = "DISPLAY";
       tblcombo.foreignValueColumnName   = "VALUE";
  

Type	Name	Description	Notes
Boolean	allowEdit	This property is true if editing is allowed for the combo box. This property should not confused with the readOnly property. A combo box may inhibit editing without being read-only. This is because editing, in this situation, only refers to the text field part of the combo box. Therefore, though editing may be inhibited, you are still able to change the value for the gadget using the pull-down menu.
Boolean	arrowShown	Contains true if the button is shown and false otherwise. When the button is not shown, the gadget looks like an entry field and the user cannot see the foreign table's contents. Initially, this property is true.
Boolean	autoFitting	Contains true if the table combo box is in auto-fitting mode. In this mode, the width of the pull-down menu is automatically adjusted to the contents of the data it contains. Initially, this property is false.
Boolean	completion	This property is true if completion is enabled for the field. The completion mechanism allows an incomplete textual representation to be completed using the foreign table. This allows the user to enter the initial characters of a word and have the gadget automatically complete the word.
Boolean	constrained	This property is true if the foreign table limits the set of possible internal values for this field. (This is implied if the foreignDisplayColumnName and the foreignValueColumnName are different.)
String	foreignDataSourceName	Contains the foreign data source name.
String	foreignDisplayColumnName	Contains the foreign display column name.
IliTable	foreignTable	Contains the foreign table. This property cannot be written to if the foreignDataSourceName property is not empty. In other words, the foreign table can be specified either literally through the foreignTable property or by name through the foreignDataSourceName property, but not both.
String	foreignValueColumnName	Contains the foreign value column name.
Int	pullDownWidth	Contains the width of the pull-down menu that must be -1 or a positive integer. When the pull-down menu is opened, it will have a width equal to the maximum of this value and the width of the gadget itself. This property can thus be used to specify that the effective width of the pull-down menu must not be less than a given value.
String	tablePropertyManagerName	Contains 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.
Boolean	useTableProperties	Contains 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.
Int	visibleRowsCount	The value of this property determines the height of the pull-down menu used to show the foreign table. When this property contains a positive value, this value is taken as the number of rows that the pull-down shows at once (without scrolling). If this property is negative then the pull-down size depends on the foreign table's number of rows. Initially, this property is set to -1.
String	tableColumns	The pull-down menu can display several columns of the foreign table. This property contains the list of displayed columns with a semicolon (;) between each column name.
Callback	Close	Called just after the pull-down menu is dismissed.
Callback	Open	Called just before the pull-down menu is shown.