SetTabOrder
method (DataWindows)
Description
Changes the tab sequence number of a column in a DataWindow control
to the specified value.
Applies to
|
DataWindow type |
Method applies to |
|---|---|
|
PowerBuilder |
DataWindow control, DataWindowChild |
Syntax
PowerBuilder
|
1 2 |
integer dwcontrol.SetTabOrder ( integer column, integer tabnumber ) integer dwcontrol.SetTabOrder ( string column, integer tabnumber ) |
|
Argument |
Description |
|---|---|
|
dwcontrol |
A reference to a DataWindow control or child |
|
column |
The column to which you are assigning a tab value. |
|
tabnumber |
The tab sequence number (0 – 9999) you want to assign |
Return value
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:
|
1 |
dw_Employee.SetTabOrder(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:
|
1 2 3 4 5 6 |
integer OldTabNum // Set OldTabNum to the previous tab order value OldTabNum = dw_employee.SetTabOrder(4, 0) ... // Some processing // Return column 4 to its previous tab value. dw_employee.SetTabOrder(4, OldTabNum) |