C++ Syntax

bool

MKI_DrawingOpenFile(

const LPCWSTR f_pszFileName,

__int32 f_nOpenFlags,

bool f_fSetName,

bool f_fMerge,

bool f_fPrompt );

Loads a drawing file from disk.

Parameters

FileName

[const LPCWSTR] File name of the drawing file to be loaded.

OpenFlags

[__int32] Bit-wise OR combination of flags that determine which sections of the drawing are to be loaded, see MKI_FILEMODE_*. Normally, this flag should be set to MKI_FILEMODE_USERSECTIONS only, thus using the current default settings. If not altered by the user, these default settings include all sections and replacing the elements.

SetName

[bool] If this value is true, the name of the currently active drawing is changed to the specified file name. Otherwise the name remains unchanged.

Merge

[bool] If this value is true, the currently active drawing will be merged with the specified drawing file. Otherwise a new drawing is created by loading the default drawing template before the specified drawing file is loaded (refer to MKI_DrawingNewFile).

Prompt

[bool] If this value is true, the function checks whether the drawing to be replaced has changed since last saving. If so, a dialog appears allowing the user to save the "old" drawing first.

Return Value

Returns true if successful. If false is returned, the drawing file could not be loaded successfully, either because it did not exist, or it was faulty, or the user did not allow the "old" drawing to be replaced (with or without saving).