SelectRow method (DataWindows)
Description
Highlights or removes highlights from rows in a DataWindow
control or DataStore. You can select all rows or a single row. SelectRow does
not affect which row is current. It does not select rows in the
database.
Controls
|
DataWindow type |
Method applies to |
|---|---|
|
PowerBuilder |
DataWindow control, DataWindowChild object, DataStore |
|
Web |
Client control |
|
Web ActiveX |
DataWindow control, DataWindowChild object |
Syntax
[PowerBuilder]
|
1 |
integer <span>dwcontrol</span>.<span>SelectRow</span> ( long <span>row</span>, boolean <span>select</span> ) |
[Web ActiveX]
|
1 |
number <span>dwcontrol</span>.<span>SelectRow</span> ( number <span>row</span>, boolean <span>select</span> ) |
|
Argument |
Description |
|---|---|
|
dwcontrol |
A reference to a DataWindow control, |
|
row |
A value identifying the row you want |
|
select |
A boolean value that determines whether
|
Return Values
Returns 1 if it succeeds and –1 if an error occurs.
If any argument’s value is null, in PowerBuilder and JavaScript
the method returns null. If there is no DataWindow object assigned
to the DataWindow control or DataStore, the method returns 1.
Usage
If a row is already selected and you specify that it be selected
(boolean is true), it remains
selected. If a row is not selected and you specify that it not be
selected (boolean is false),
it remains unselected.
Examples
This statement selects the fifteenth row in dw_employee:
|
1 |
dw_employee.<span>SelectRow</span>(15, true) |
As the script for a DataWindow’s Clicked
event, this example removes highlighting from all rows and then
highlights the row the user clicked. Row is
an argument passed to the event script:
|
1 |
This.<span>SelectRow</span>(0, false) |
|
1 |
This.<span>SelectRow</span>(row, true) |