Skip to content

piInitialColumn - cDbCJGridPromptList

Allows you to specify the column the prompt list should start in

Type: Property
Access: Read/Write
Data Type: Integer
Parameters: None

Syntax

Property Integer piInitialColumn
Access Type Syntax
Read Access: Get piInitialColumn to IntegerVariable
Write Access: Set piInitialColumn to IntegerVariable/Value

Description

Normally, the prompt list determines which column to start in automatically. If the prompt list is relational (peUpdateMode is umPromptRelational), it will pick the column that best matches the invoking object's data entry object (DEO) binding information. If the prompt list is not relational, it uses the column specified in piUpdateColumn.

The default value for piInitialColumn is -1, which means that it should use the above strategy. If you wish to specify a different initial column, you may do so by setting piInitialColumn.

Often this property will be set inside of the invoking object's Prompt_Callback event.

// this forces a simple value update for column 0 (id)
// with the initial column being column 1 (name)
Procedure Prompt_Callback Integer hPrompt
      Set peUpdateMode of hPrompt to umPromptValue
      Set piUpdateColumn of hPrompt to 0
      Set piInitialColumn of hPrompt to 1
End_Procedure