3.70 DM_StopDialog

This function cancels a dialog. If that dialog was the last running dialog the event loop is left. If no dialog is specified the current dialog is stopped.

DM_Boolean DML_default DM_EXPORT DM_StopDialog
(
  DM_ID dialogID,
  DM_Options options
)

Parameters

-> DM_ID dialogID

Identifier of the dialog to be stopped. This identifier was received as the return value from DM_LoadDialog

-> DM_Options options

In this parameter the following values are possible:

Option

Meaning

DMF_Destroy

This option means that the stopped dialog is to be deleted. If this option is not set, the stopped dialog will remain in the memory and be restarted.

Return Value

TRUE

The dialog could be stopped successfully.

FALSE

The dialog could not be stopped.

See Also

Built-in function stop() in manual “Rule Language”