first( )

Topic group Related topics

Moves the row cursor to the first row in the rowset.

Syntax

<oRef>.first( )

<oRef>

The rowset in which you want to move the row cursor.

Property of

Rowset

Description

Call first( ) to move the row cursor to the first row in the rowset. If a filter is active, it moves the row cursor to the first row in the rowset matching the filter criteria.

As a navigation method, first( ) interacts with canNavigate, onNavigate, and implicit saves. For more information, see next( ).

If a call to first( ) results in the endOfSet property returning true, either no rows remain that match the filter criteria or, if no filter is in use, no rows remain in the rowset.

Note

Using the rowset's navigateByMaster property to synchronize movement in master-detail rowsets, modifies the behavior of the atLast( ) method. See navigateByMaster for more information.