canNavigate

Topic group Related topics

Event fired when attempting navigation in a rowset; return value determines if row cursor is moved.

Parameters

none

Property of

Rowset

Description

Navigation in a rowset may occur explicitly by calling a navigation method like next( ) or goto( ), or implicitly via the user interface by choosing a navigation option from the default Table menu or toolbar while viewing a rowset. canNavigate may be used to verify that the user wants to leave the current row to go to another. You may check the modified property first to see if the user has made any changes to the current row; if not, you may not want to ask.

canNavigate may also be used to do something with the current row, just before you leave it. In this case, the canNavigate event handler would always return true.

The canNavigate event handler must return true or false to indicate whether the navigation occurs. For information on how canNavigate interacts with other events and implicit saves, see next( ).