Chapter 9: Methods for the DataWindow Control

SetColumn

Description

Sets the current column in a DataWindow control or DataStore.

Syntax

integer dwcontrol.SetColumn ( string column)

integer dwcontrol.SetColumn ( integer column)

Argument	Description
dwcontrol	A reference to a DataWindow control, DataStore, or child DataWindow.
column	The column you want to make current. Column can be a column number or a column name.

Returns

Returns 1 if it succeeds and -1 if an error occurs. If column is less than 1 or greater than the number of columns, SetColumn fails. If any argument’s value is NULL, the method returns NULL.

Usage

SetColumn moves the cursor to the current column but does not scroll the DataWindow control.

Only an editable column can be current. (A column is editable when its tab order value is greater than 0.) Do not try to set a noneditable column as the current column.

Using with other PocketBuilder controls For use with ListView controls, see SetColumn in the PowerScript Reference.

Events

SetColumn can trigger these events:

ItemChanged
ItemError
ItemFocusChanged

Avoiding infinite loops Never call SetColumn in the ItemChanged, ItemError, or ItemFocusChanged event. Because SetColumn can trigger these events, such a recursive call can cause a stack fault.

Examples

Example 1

This statement makes the 15th column in dw_Employee the current column:

dw_Employee.SetColumn(15)