DataSourceIsDirty

Note: This page includes content based on the F1 documentation for Centura development. It may be partially converted to support APF development, but should be regarded to be of uncertain actuality. It is provided as is. Eventually, it should be replaced by documentation available from within Visual Studio.

SalNumber DataSourceIsDirty( SalNumber nWhat )

Applications and the framework call the DataSourceIsDirty method to check if any changes have been to a data source, or to ask the user to save the changes.

Parameters

Name Description
SalNumber nWhat Standard method parameter. Possible values are Const.METHOD_Inquire, Const.METHOD_Execute, Const.METHOD_GetType.

Returns

When nWhat = Const.METHOD_Inquire: the return value is TRUE if any changes have been made in the data source.

When nWhat = Const.METHOD_Execute: the return value is TRUE if the changes where saved successfully, or the user choose not to save the changes. Otherwise the return value is FALSE.

When nWhat = Const.METHOD_GetType, the return value is Const.CHILDTYPE_SourceMethod.

Comments

DataSourceIsDirty is called automatically by the framework when a data source receives the Const.PM_DataSourceIsDirty message.