C++ Syntax

bool

MKI_DialogTextStandardMulti(

HWND f_hWindow,

const LPCWSTR f_pszCaption,

MKI_MULTI_TEXTSTANDARD_PTR f_pTextStandard,

MKI_MULTI_TEXTREFERENCE_PTR f_pTextReference );

Shows and processes a dialog for multi-entity standard text parameter editing.

Parameters

f_hWindow

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

f_pszCaption

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

f_pTextStandard

[MKI_MULTI_TEXTSTANDARD_PTR] Address of a multi-entity standard text parameter set. If this address is not nullptr, the standard text parameters will be used to initialize the dialog window, and they will receive the selected standard text parameters if the user ends the dialog by pressing the OK button.

f_pTextReference

[MKI_MULTI_TEXTREFERENCE_PTR] Address of a multi-entity reference text parameter set. If this address is not nullptr, the reference text parameters will be used to initialize the dialog window, and they will receive the selected reference text parameters if the user ends the dialog by pressing the OK button.

Return Value

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

Comment

Depending on the values of f_pTextStandard and f_pTextReference, the dialog does have controls to edit the standard parameters and/or a button to branch to reference text parameter editing.