C++ Syntax

MKI_RESULTVALUE

MKI_DrawingImportHpgl(

const LPCWSTR f_pszFileName,

__int32 f_nImportContext,

__int32 f_nFilterMode,

MKI_CONST_DWGDXF_IMPORT_PTR f_pData );

Imports data from a DWG file. The imported data will be added to the current drawing.

All imported entities will be marked with MKI_FLAG_PREVIOUS. You can use that to handle them afterwards using e.g. MKI_EditFitAlign() with f_nFlag set to MKI_FLAG_PREVIOUS.

Not supported in CAD6starter and CAD6engine! Requires the corresponding plug-in to be installed and active.

Parameters

f_pszFileName

[const LPCWSTR] File name of the DWG file to be imported.

f_nImportContext New in Version 2026.0

[__int32] Import context. Possible values:

MKI_IMPORTCONTEXT_OPEN

The drawing shall replace the current drawing data. The plug-in should call MKI_DrawingNewFile or similar code before importing the data.

MKI_IMPORTCONTEXT_MERGE

The drawing shall be added to the current drawing data. This is the same behavior as when importing on explicit user command. The plug-in should create its own undo level using MKI_UndoInitProcess, MKI_UndoCancelProcess and MKI_UndoFinishProcess.

MKI_IMPORTCONTEXT_REF

Similar to MKI_IMPORTCONTEXT_OPEN, but the plug-in should use settings appropriate for loading a referenced drawing (e.g. loading only Model Space contents).

f_nFilterMode

[__int32] A bit-wise OR combination of special filter modes. It can be any combination of the following values:

MKI_FILTERMODE_NULL

No special mode.

MKI_FILTERMODE_NO_ERROR

The import filter shall not display any (interrupting) messages in case of errors and no interrupting user interaction.

MKI_FILTERMODE_NO_FEEDBACK

The import filter shall not display any (non-interrupting) progress indication dialogs or other optical feedback.

MKI_FILTERMODE_NO_REDRAW

The import filter shall not redraw the drawing data or any window contents after a successful import.

f_pData

[MKI_CONST_DWGDXF_IMPORT_PTR] Address of a buffer containing the DWG import parameters to be used. If nullptr, the plug-in's current parameters will be used.

Return Value

Enumeration result as a bit-wise OR combination of flags (see MKI_RESULT_*). Some results indicate minor problems and do NOT mean that the import was stopped or unsuccessful!