ScrollToRow
method (DataWindows)
Description
Scrolls a DataWindow control to the specified row. ScrollToRow
changes the current row but not the current column.
Applies to
|
DataWindow type |
Method applies to |
|---|---|
|
PowerBuilder |
DataWindow control, DataWindowChild |
Syntax
PowerBuilder
|
1 |
integer dwcontrol.ScrollToRow ( long row ) |
|
Argument |
Description |
|---|---|
|
dwcontrol |
A reference to a DataWindow control or child |
|
row |
A value identifying the row to which you want to |
Return value
Returns the number of the row to which the DataWindow scrolls 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
After you call ScrollToRow, the specified row becomes the new
current row. If that row is already visible, the displayed rows do not
change. If the row is not visible, the displayed rows change to display
the row.
ScrollToRow does not highlight the row. Use SelectRow to let the
user know what row is current.
Events
ScrollToRow can trigger these events:
| ItemChanged |
| ItemError |
| ItemFocusChanged |
| RowFocusChanged |
Examples
This statement scrolls to row 10 and makes it current in the
DataWindow control dw_employee:
|
1 |
dw_employee.ScrollToRow(10) |
See also