C++ Syntax

bool

MKI_DialogAnyEntity(

HWND f_hWindow,

const LPCWSTR f_pszCaption,

MKI_MULTI_INFO_REF f_rData,

bool* f_pfDuplicate,

__int32* f_pnIdentical );

Shows and processes a dialog for property editing of a single arbitrary entity based on a MKI_MULTI_INFO structure.

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_MULTI_INFO_REF] Address of an extended property set. This extended property set is used to initialize the dialog window, and it will receive the selected extended property set if the user ends the dialog by pressing the OK button.

Duplicate

[bool*] Pointer to a boolean value used to handle a "Duplicate" check box in the dialog. It is used to initialize the control and will receive the control’s state when exiting the dialog. If Duplicate is nullptr, the "Duplicate" check box will not be visible.

Identical Changed in Version 2019.1

[__int32*] Pointer to an integer value used to handle two "Identical" check boxes in the dialog. It is used to initialize the control and will receive the control’s state when exiting the dialog. If Identical is nullptr, the "Identical" check boxes will not be visible.

Return Value

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