C++ Syntax

bool

MKI_DialogName(

HWND f_hWindow,

const LPCWSTR f_pszCaption,

const LPCWSTR f_pszPrefix,

LPWSTR f_pszName,

const size_t f_unMaxSize );

Shows and processes the dialog that allows editing a standard name. Such a standard name must be empty and must not begin with a '*' character.

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.

Prefix

[const LPCWSTR] Text to be displayed in front of the edit field. Be careful that the given text fits into the dialog.

Name

[LPWSTR] Address of the name to be edited.

MaxSize

[const size_t] Maximum allowed size of the name in bytes including the terminating zero.

Returns true if the dialog window was ended by pressing the OK button (no matter if anything inside the window was changed), else false.