SetColumn

Description

Sets the current column in a Web DataWindow client control.

Applies to

Web DataWindow client control

Syntax

number objdwcontrol.SetColumn ( string column ) 
number objdwcontrol.SetColumn ( number column ) 

Argument

Description

objdwcontrol

A reference to a Web DataWindow client control.

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.

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.

NoteAvoiding 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.