SetTabOrder method (DataWindows)

Description

Changes the tab sequence number of a column in a DataWindow
control to the specified value.

Controls

DataWindow type	Method applies to
PowerBuilder	DataWindow control, DataWindowChild object
Web ActiveX	DataWindow control, DataWindowChild object

Syntax

[PowerBuilder]

integer <span>dwcontrol</span>.<span>SetTabOrder</span> ( integer <span>column</span>, integer <span>tabnumber</span> )<br>integer <span>dwcontrol</span>.<span>SetTabOrder</span> ( string <span>column</span>, integer <span>tabnumber</span> )

1	integer <span>dwcontrol</span>.<span>SetTabOrder</span> ( integer <span>column</span>, integer <span>tabnumber</span> )<br>integer <span>dwcontrol</span>.<span>SetTabOrder</span> ( string <span>column</span>, integer <span>tabnumber</span> )

[Web ActiveX]

number <span>dwcontrol</span>.<span>SetTabOrder</span> ( number <span>column</span>, number <span>tabnumber</span> ) <br>number <span>dwcontrol</span>.<span>SetTabOrder</span> ( string <span>column</span>, number <span>tabnumber</span> )

1	number <span>dwcontrol</span>.<span>SetTabOrder</span> ( number <span>column</span>, number <span>tabnumber</span> ) <br>number <span>dwcontrol</span>.<span>SetTabOrder</span> ( string <span>column</span>, number <span>tabnumber</span> )

Argument	Description
dwcontrol	A reference to a DataWindow control or child DataWindow in which you want to define the tab order.
column	The column to which you are assigning a tab value. Column can be a column number or a column name. The column number is the number of the column as it is listed in the Column Specification view of the DataWindow painter—not necessarily the number of the column in the Design view.
tabnumber	The tab sequence number (0 – 9999) you want to assign to the DataWindow column. 0 removes the column from the tab order, which makes it read-only.

Return Values

Returns the previous tab value of the column if it succeeds
and –1 if an error occurs. If any argument’s value
is null, in PowerBuilder and JavaScript the method returns null.

Usage

You can change a column in a DataWindow object to read-only
by changing the tab sequence number of the column to 0.

Examples

This statement changes column 4 of dw_Employee
to read-only:

dw_Employee.<span>SetTabOrder</span>(4, 0)

1	dw_Employee.<span>SetTabOrder</span>(4, 0)

These statements change column 4 of dw_employee
to read-only and later restore the column to its original tab value
with read/write status:

integer OldTabNum

1	integer OldTabNum

// Set OldTabNum to the previous tab order value

1	// Set OldTabNum to the previous tab order value

OldTabNum = dw_employee.<span>SetTabOrder</span>(4, 0)

1	OldTabNum = dw_employee.<span>SetTabOrder</span>(4, 0)

... // Some processing

1	... // Some processing

// Return column 4 to its previous tab value.

1	// Return column 4 to its previous tab value.

dw_employee.<span>SetTabOrder</span>(4, OldTabNum)

1	dw_employee.<span>SetTabOrder</span>(4, OldTabNum)

Document get from Powerbuilder help

Thank you for watching.

Powerbuilder Documentation 15.0

August 20, 2023

Was this article helpful?

Connection Information

SetTabOrder – PB Docs 150