C++ Syntax

bool

MKI_DrawingSaveFile(

const LPCWSTR f_pszFileName,

__int32 f_nFileVersion,

__int32 f_nSaveFlags,

bool f_fPrompt,

bool f_fAddToRecent );

Saves the current drawing to disk.

Parameters

f_pszFileName

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

f_nFileVersion New in Version 2026.0

[__int32] File format version to write. Can be either one of the following modes or an explicit file version number (such as 6210 for "CAD6 Release 2021.0"):

MKI_FILEVERSION_LATEST

The latest file version supported by the application (usually MKI_MKD_VERSION).

MKI_FILEVERSION_CURRENT

The current file version of the drawing.

Be advised that forcing an older file format version may result in information loss due to limitations of the older file format!

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 f_pszFileName already exists. If so, a dialog appears allowing the user to cancel.

f_fAddToRecent New in Version 2026.0

[bool] If true, the drawing's file name will be added to the recently used file names list.

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.