C++ Syntax

bool

MKI_DialogCreateBlock(

HWND f_hWindow,

const LPCWSTR f_pszCaption,

MKI_CREATEBLOCK_DATA_REF f_rData,

__int32 f_nDialogMode );

Shows and processes a dialog for block creation.

Parameters

Window

[HWND] Handle of the dialog window's parent window.

Caption

[const LPCWSTR] Title of the dialog window to be displayed. Be careful that the given title fits into the dialog window's caption.

Data

[MKI_CREATEBLOCK_DATA_REF] Address of the dialog data. This data will be used to initialize the dialog window, and it will receive the changed if the user ends the dialog by pressing the OK button.

DialogMode

[__int32] This parameter is a bit-wise OR combination of several flags that disable or hide single settings of this dialog window. By this means, the plug-in can control which settings can be altered by the user. The flags are defined in MKI_CREATEBLOCK_DATA.

Return Value

Returns true if the dialog window was ended by pressing the OK button, else false.