C++ Syntax

bool

MKI_DialogFileOptions(

HWND f_hWindow

const LPCWSTR f_pszCaption,

__int32* f_pnCurrentSet,

__int32* f_pnCurrentVersion,

__int32 f_nFileOptions );

Shows and processes a dialog for MKD file load/save options.

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_pCurrentSet

[__int32*] Address of a 32bit value containing a bit-wise OR combination of different file modes, see MKI_FILEMODE_*. This value will be used to initialize the dialog’s list box, and will receive the user’s selection. May be nullptr, in which case the list box will be disabled.

f_pCurrentVersion New in Version 2026.0

[__int32*] Address of a 32bit value containing the file version. This value will be used to initialize the dialog’s combo box, and will receive the user’s selection. May be nullptr, in which case the combo box will be hidden.

f_nFileOptions New in Version 2026.0

[__int32] Indicates for which use-case the dialog shall be displayed. Possible values are:

MKI_FILEOPTIONS_NONE

The user cannot access or change any default values.
The user cannot modify element modes "Replace", "Merge", or "Add".

MKI_FILEOPTIONS_DRAWING_LOAD

The user can access and change the default values for loading drawings (file version only).
The user cannot modify element modes "Replace", "Merge", or "Add".

MKI_FILEOPTIONS_DRAWING_SAVE

The user can access and change the default values for saving drawings (file mode and file version).
The user cannot modify element modes "Replace", "Merge", or "Add".

MKI_FILEOPTIONS_DRAWING_NEW

The user can access and change the default values for creating new drawings (file version only).
The user cannot modify element modes "Replace", "Merge", or "Add".

MKI_FILEOPTIONS_DRAWING_IMPORT

The user can access and change the default values for importing data from a drawing file into the current drawing (file mode only).
The user can choose between element modes "Replace", "Merge", or "Add".

MKI_FILEOPTIONS_CLIPBOARD_PASTE

The user can access and change the default values for pasting clipboard data into the current drawing (file mode only).
The user can choose between element modes "Replace", "Merge", or "Add".

MKI_FILEOPTIONS_TEMPLATE_IMPORT

The user can access and change the default values for importing elements from a drawing template into the current drawing (file mode only)
The user can choose between element modes "Replace", "Merge", or "Add".

MKI_FILEOPTIONS_TEMPLATE_SAVE

The user can access and change the default values for saving drawing templates (file mode and file version).
The user cannot modify element modes "Replace", "Merge", or "Add".

MKI_FILEOPTIONS_LIBRARY_SAVE

The user can access and change the default values for saving libraries (file version only).
The user cannot modify element modes "Replace", "Merge", or "Add".

Return Value

Returns true if the dialog window is ended by pressing the OK button and anything inside the window is changed, else false. When ending the dialog by pressing OK, f_pCurrentSet and f_pCurrentVersion contains the user’s selection.