C++ Syntax

bool

MKI_DialogTextStandard(

HWND f_hWindow,

const LPCWSTR f_pszCaption,

MKI_TEXTSTANDARD_PTR f_pTextStandard,

MKI_TEXTREFERENCE_PTR f_pTextReference,

LPWSTR f_pszEditText,

const size_t f_unMaxSize,

bool f_fAllowCurrentSystem,

bool f_fReadOnly );

Shows and processes a dialog for standard text editing or viewing (including text parameters).

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_TEXTSTANDARD_PTR] Address of a 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_TEXTREFERENCE_PTR] Address of a 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.

f_pszEditText

[LPWSTR] Address of a text. If this address is not nullptr, the text will be used to initialize the dialog window, and it will receive the edited text if the user ends the dialog by pressing the OK button.

f_unMaxSize

[const size_t] Maximum allowed size of the text in characters including the terminating zero. Maximum allowed value is MKI_LENGTH_TEXT_LONG.

f_fAllowCurrentSystem New in Version 2018.1

[bool] If true, the dialog will allow the user to choose "Current" (-1) as coordinate system in f_pTextStandard->m_nSystem.

f_fReadOnly New in Version 2020.2

[bool] If true, the dialog will be in read-only mode.

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, f_pTextReference, and f_pszEditText, the dialog does have an edit control, controls to edit the standard parameters and/or a button to branch to reference text parameter editing. If e.g. only f_pszEditText is not nullptr, a simple text editing control appears.