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.
Applies to
|
DataWindow type |
Method applies to |
|---|---|
|
PowerBuilder |
DataWindow control, DataWindowChild object, DataStore |
Syntax
PowerBuilder
|
1 |
integer dwcontrol.SelectRow ( long row, boolean select ) |
|
Argument |
Description |
|---|---|
|
dwcontrol |
A reference to a DataWindow control, DataStore, or |
|
row |
A value identifying the row you want to select or |
|
select |
A boolean value that determines whether the row is
|
Return value
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.SelectRow(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 2 |
This.SelectRow(0, false) This.SelectRow(row, true) |
See also