PM_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.

Const.PM_DataSourceIsDirty

The Const.PM_DataSourceIsDirty message is sent to a data source to inquire if the data source (or one of it's child data sources) has been edited, or to verify that there are no unsaved changes to a data source.

Parameters

Name Description
nWhat = wParam Standard method parameter. Possible values are Const.METHOD_Inquire, Const.METHOD_Execute, Const.METHOD_GetType
lParam Unused

Returns

When nWhat = Const.METHOD_Inquire, TRUE is if the data source or any of it's child data sources have been edited..

When nWhat = Const.METHOD_Execute, the return value is TRUE if no changes had been made, or if changes had been made and the user choose Yes or No to the "Save changes" question. If the user chooses Cancel to that question, FALSE is returned.

Comments

Applications should first use the Const.PM_DataSourceIsDirty message with Const.METHOD_Inquire to check if a data source has been edited, and then with Const.METHOD_Execute prompt the user to save or discard the changes.