Purpose

.HideFirstColumn property turns a combo box into a Data Driven combo box. In effect, this will hide the first column of a combo box from the user, render the second column, but write the value of column 1 to the PROIV Virtual Machine.  

Syntax

ObjectReference.HideFirstColumn  = Value

Operation

ObjectReference is the Tag Name of the object.
Value is the setting for the hide first column property. (TRUE or 1 = hide first column, FALSE or 0 = first column visible and combo box in the standard PROIV manner.
 

Remarks

The value of this property can be set and retrieved.

The default is FALSE.

If a combo box object has this property set to TRUE, the rendition and behaviour of the combo box changes.  

The combo box behaviour is as follows in these scenarios:

Combo Box Displaying Existing Data

When you enter a screen with a combo box displaying existing data, the screen renders the column 2 associated data, that corresponds to the field value of the combo box.

No Existing Data in Combo Box

If a combo box is opened (by a press or F4), the selection cycle is executed but the first column is hidden.

Data Entry in Combo Box

You can enter characters corresponding to the rendition values in the column 2, but the actual value returned to the PROIV Virtual Machine is taken from column 1 of the same row.

Example

To set the .HideFirstColumn property of a combo box whose Tag Name is AddressComboBox:

AddressComboBox.HideFirstColumn = TRUE