Description
Scrolls a DataWindow control to the next row (forward one row). ScrollNextRow changes the current row, but not the current column.
Applies to
Syntax
PowerBuilder
long dwcontrol.ScrollNextRow ( )
Return value
Returns the number of the row displayed at the top of the DataWindow control when the scroll finishes or tries to scroll past the last row. ScrollNextRow returns -1 if an error occurs.
If dwcontrol is null, in PowerBuilder and JavaScript the method returns null.
Usage
After you call ScrollNextRow, the row after the current row becomes the new current row. If that row is already visible, the displayed rows do not change. If it is not visible, the displayed rows move up to display the row.
ScrollNextRow does not highlight the row. Use SelectRow to let the user know what row is current.
Events
ScrollNextRow triggers these events in the order shown:
| RowFocusChanging |
| RowFocusChanged |
| ItemFocusChanged |
| ScrollVertical |
You should not use ScrollNextRow in the ScrollVertical event. Doing so causes this series of events to be triggered repeatedly until the last row in the DataWindow is reached.
Examples
This statement scrolls dw_employee to the next row:
dw_employee.ScrollNextRow()
See also
