Scrolls to the prior row in a DataWindow control.
To scroll |
Use |
|---|---|
To the prior row in a DataWindow, making the row current (when the DataWindow does not have the RichTextEdit presentation style) |
|
To the prior instance of a document associated with a row in a RichTextEdit control or RichTextEdit DataWindow |
Scrolls a DataWindow control backward one row. ScrollPriorRow changes the current row but not the current column.
long dwcontrol.ScrollPriorRow ( )
Argument |
Description |
|---|---|
dwcontrol |
A reference to a DataWindow or child DataWindow |
Returns the number of the row displayed at the top of the DataWindow control when the scroll finishes or tries to scroll past the first row. ScrollPriorRow returns -1 if an error occurs. If dwcontrol is NULL, the method returns NULL.
After you call ScrollPriorRow, the row before 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 down to display the row.
ScrollPriorRow does not highlight the row. Use SelectRow to let the user know what row is current.
ScrollPriorRow triggers these events in the order shown:
RowFocusChanging
RowFocusChanged
ItemFocusChanged
ScrollVertical
You should not use ScrollPriorRow in the ScrollVertical event. Doing so causes this series of events to be triggered repeatedly until the first row in the DataWindow is reached.
This statement scrolls dw_employee to the prior row:
dw_employee.ScrollPriorRow()
Scrolls to the prior instance of the document in a RichTextEdit DataWindow.
PowerBuilder DataWindow control
integer rtename.ScrollPriorRow ( )
Returns 1 if it succeeds and -1 if an error occurs.
| Copyright © 2004. Sybase Inc. All rights reserved. |
|
|
