de_simple_dialog_cancel_cb()

A general purpose cancel callback. Closes (but does not destroy) the dialog. The state of the dialog is preserved. Returns: none.

Syntax:

de_simple_dialog_cancel_cb(cancelH, dialogH, winInst);

where

cancelH is a handle to the cancel button.

dialogH is a handle to the dialog to close.

winInst is the handle of the window.

Example:

decl cancelH, dialogH;
if (dialogH == NULL)
{
dialogH = api_dlg_create_dialog("myDialog", winInst,
cancelH = api_dlg_create_item("cancelButton", API_PUSH_BUTTON_ITEM, 
API_RN_CAPTION, "CANCEL");
); //end api_dlg_create_dialog
api_dlg_add_callback( cancelH, "de_simple_dialog_cancel_cb", 
API_ACTIVATE_CALLBACK, dialogH);
}

Where Used:

Schematic