C++ Syntax

bool

MKI_DrawingSaveFile(

const LPCWSTR f_pszFileName,

__int32 f_nSaveFlags,

bool f_fPrompt );

Saves the current drawing to disk.

Parameters

f_pszFileName

[const LPCWSTR] File name of the drawing file to be created. If FileName is nullptr, the current drawing's file name is used. If FileName is nullptr and the current drawing is untitled, the function returns false.

f_nSaveFlags

[__int32] Bit-wise OR combination of flags that determine which sections of the drawing are to be saved, see MKI_FILEMODE_*. Normally, this flag should be set to either MKI_FILEMODE_ALL (save everything) or MKI_FILEMODE_USERSECTIONS (use the current default settings).

f_fPrompt

[bool] If true, the function checks whether the drawing file passed in FileName already exists. If so, a dialog appears allowing the user to cancel.

Return Value

Returns true if successful. If false is returned, the file has not been saved successfully, because the disk was full, the file name was invalid, or the user did not allow to overwrite an already existing file.

Comment

If the drawing was untitled before, the file name stated in FileName will be assigned to the drawing.