C++ Syntax

__int32

MKI_DialogBoxParam(

HINSTANCE f_hInstance,

LPCSTR f_pszTemplateName,

HWND f_hWindow,

DLGPROC f_fnDialogFunc,

LPARAM f_lInitParam );

Displays and handles a dialog based on the given template. This function replaces the Windows function DialogBoxParam(), but automatically scales the template according to the user settings.

In situations where you need direct access to the converted template (e.g. for property sheets or common dialogs), create the converted template using an instance of MKI_DIALOG_TEMPLATE.

Any dialog template passed to this function should be designed using an 8 pt standard font ("MS Sans Serif" or "MS Shell Dlg"), which will subsequently be replaced by the user-defined font size and type. The template should use the DIALOGEX style and must have the DS_SETFONT flag set.

Parameters

Instance

[HINSTANCE] Instance handle of the plug-in that contains the template.

TemplateName

[const LPCSTR] Name of the template in the given plug-in.

Window

[HWND] Handle of the parent window to the tracking popup menu.

DialogFunc

[DLGPROC] Pointer to the dialog box procedure. For more information about the dialog box procedure, see the Windows SDK documentation.

InitParam

[LPARAM] Specifies the value to pass to the dialog box in the lParam parameter of the WM_INITDIALOG message.

Return Value

If the function succeeds, the return value is the nResult parameter specified in the call to the EndDialog() function that was used to terminate the dialog box. Otherwise, 0 or -1 is returned.