Syntax 1 For DataWindow controls and child DataWindows

Description

Scrolls a DataWindow control backward one page, displaying another group of rows in the DataWindow's display area. (A page is the number of rows that can be displayed in the DataWindow control at one time.) ScrollPriorPage changes the current row but not the current column.

Applies to

DataWindow type

Method applies to

PowerBuilder

DataWindow control, DataWindowChild object


Syntax

PowerBuilder

long dwcontrol.ScrollPriorPage ( )

Argument

Description

dwcontrol

The name of the DataWindow control or child DataWindow you want to page (scroll) to the prior page


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 first row. ScrollPriorPage returns -1 if an error occurs.

If dwcontrol is null, in PowerBuilder and JavaScript the method returns null.

Usage

ScrollPriorPage does not highlight the current row. Use SelectRow to let the user know what row is current.

Events

ScrollPriorPage can trigger these events:

ItemChanged
ItemError
ItemFocusChanged
RowFocusChanged
RowFocusChanging

Examples

This statement scrolls dw_employee backward one page:

dw_employee.ScrollPriorPage()

See also

Scroll

ScrollFirstPage

ScrollLastPage

ScrollNextPage

ScrollNextRow

ScrollPriorRow

ScrollToRow

SelectRow