piInitialColumn - cWebPromptList

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

Type: Property (Web Property)

Access: Read/Write

Data Type: Integer

Parameters: None

Syntax
 { WebProperty=Client }
 Property Integer piInitialColumn

Web Property Read Access: WebGet piInitialColumn to IntegerVariable
Web Property Write Access: WebSet piInitialColumn to IntegerVariable/Value

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


About Web Properties
Each web property maintains two values: The regular property value is set during object creation and should not be changed during the lifetime of that object. To access that value, use the standard property Get and Set syntax.
The web property value is the local value stored at each client. This is synchronized to the client's local value whenever a server call is being processed. To access the web property value, use the WebGet and WebSet syntax above instead of the standard Get and Set syntax.