C++ Syntax

bool

MKI_DialogFileOptions(

HWND f_hWindow

const LPCWSTR f_pszCaption,

__int32* f_pnCurrentSet,

__int32 f_nDefaultMode,

bool f_fMerge );

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

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.

CurrentSet

[__int32*] Address of a 32bit value containing a bit-wise OR combination of different file options. Please see MKI_DrawingOpenFile or MKI_DrawingSaveFile for details on file options. This value will be used to initialize the options’ list box, and will receive the user’s selection.

DefautMode

[__int32] Indicates which default value can be used and/or modified in the dialog by means of the "Use Default Value" and "Save Default Value" buttons. Possible values are:

MKI_FILEOPTIONS_NONE

No default value can be used and/or modified, the two buttons are disabled.

MKI_FILEOPTIONS_LOAD

The default value for loading drawings can be used and/or modified.

MKI_FILEOPTIONS_SAVE

The default value for saving drawings can be used and/or modified.

MKI_FILEOPTIONS_NEW

The default value for creating new drawings can be used and/or modified.

MKI_FILEOPTIONS_IMPORT New in Version 6.50

The default value for importing drawings into the current drawing can be used and/or modified.

MKI_FILEOPTIONS_CLIP New in Version 6.50

The default value for pasting clipboard data into the current drawing can be used and/or modified.

Merge

[bool] If Merge is true, the user can choose between "Replace", "Merge" and "Add" mode. Otherwise, these controls are hidden.

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, CurrentSet contains the user’s selection.