canAppend

Topic group Related topics

Event fired when attempting to put rowset in Append mode; return value determines if the mode switch occurs.

Parameters

none

Property of

Rowset

Description

A rowset may be put in Append mode explicitly by calling its beginAppend( ) method, or implicitly via the user interface by choosing Append Row from the default Table menu or toolbar while editing table rows. canAppend may be used to verify that the user wants to add a new row. You can 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.

The canAppend event handler must return true or false to indicate whether beginAppend( ) proceeds. For information on how canAppend interacts with other events and implicit saves, see beginAppend( ).