ScrollToRow method (DataWindows)
Description
Scrolls a DataWindow control to the specified row. ScrollToRow changes the
current row but not the current column.
Controls
|
DataWindow type |
Method applies to |
|---|---|
|
PowerBuilder |
DataWindow control, DataWindowChild object |
|
Web ActiveX |
DataWindow control, DataWindowChild object |
Syntax
[PowerBuilder]
|
1 |
integer <span>dwcontrol</span>.<span>ScrollToRow</span> ( long <span>row</span> ) |
[Web ActiveX]
|
1 |
number <span>dwcontrol</span>.<span>ScrollToRow</span> ( number <span>row</span> ) |
|
Argument |
Description |
|---|---|
|
dwcontrol |
A reference to a DataWindow control or |
|
row |
A value identifying the row to which |
Return Values
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.<span>ScrollToRow</span>(10) |