MKI_MULTI_REF (Multi-Entity Editing Classes) Changed in Version 2026.0

C++ Syntax

class MKI_MULTI_REF : public MKI_MULTI_BASE

{

  public:

  MKI_FILEREFERENCE m_szDrawingName;

  MKI_FILENAMEW m_szLocatedFileName;

  MKI_VECTOR m_cScaling;

  double m_dRotation,

         m_dDistortion;

  MKI_POINT m_cPointUnits;

  __int32 m_nDisplayMode;

          m_nFileType;

  MKI_DRAWINGREF m_cOptions;

  MKI_HIDELAYERS m_afHideLayers;

  bool m_fClearCache;  // Internal Data - do not modify!

  void

  Init( void ); New in Version 2023.1

  void

  Fill(

 MKI_CONST_ENTITY_REF_PTR f_pRef ); New in Version 2023.1

  bool

  Apply(

 MKI_ENTITY_REF_PTR f_pRef,

 bool f_fCopyAll ) const; New in Version 2023.1

};

This structure contains external drawing reference properties to be edited in a dialog window.

Element Description

m_szDrawingName Changed in Version 2019.1

[MKI_FILEREFERENCE] File name of the drawing that this reference is (originally) pointing to.

m_szLocatedFileName New in Version 2026.0

[MKI_FILENAMEW] Location were the referenced file was found this time. May deviate from the original location.

m_cScaling Changed in Version 6.41

[MKI_VECTOR] Horizontal and vertical scaling of the reference.

m_dRotation

[double] Rotation of the reference in [rad].

m_dDistortion

[double] Distortion of the reference in [rad].

m_cPointUnits New in Version 2023.1

[MKI_POINT] X and Y coordinate of the reference’s insertion point in current length units (not in internal millimeters).

m_nDisplayMode

[__int32] Bit-wise OR combination of some flags indicating the display mode for the external drawing. Possible values are (see MKI_DISPLAYMODE_*):

MKI_DISPLAYMODE_SCALED_WIDTH

MKI_DISPLAYMODE_CONFINED

MKI_DISPLAYMODE_NOGEO

MKI_DISPLAYMODE_ADAPT_ANGLE

MKI_DISPLAYMODE_SCALED_LENGTH

MKI_DISPLAYMODE_ADAPT_SCALE

MKI_DISPLAYMODE_NOHIDE New in Version 2021.1

m_nFileType New in Version 2026.0

[__int32] File type of the referenced file. Possible values are (see MKI_FILETYPE_*):

MKI_FILETYPE_MKD

MKI_FILETYPE_DWG

MKI_FILETYPE_DXF

MKI_FILETYPE_PDF

m_cOptions New in Version 2026.0

[MKI_DRAWINGREF] Import options for non-MKD references.

m_afHideLayers New in Version 2018.0

[MKI_HIDELAYERS] This array contains one bit for each layer indicating if the layer shall be output or not.

m_fClearCache New in Version 2026.0

[bool] Will be set to true if changes to the reference's settings make it necessary to clear a possible cache file.

Comment

When using functions of the base class MKI_MULTI_BASE, use the following flags defined in this class to identify its elements:

USE_NAME

Apply the drawing file name m_szDrawingName and the options in m_cOptions.

USE_XSCALE

Apply the horizontal scaling m_cScaling.vx.

USE_YSCALE

Apply the vertical scaling m_cScaling.vy.

USE_ROTATION

Apply the rotation m_dRotation.

USE_DISTORTION

Apply the distortion m_dDistortion.

USE_XPOS

Apply the insert point’s X-coordinate m_cPosition.x.

USE_YPOS

Apply the insert point’s Y-coordinate m_cPosition.y.

USE_SCALEDWIDTH

Apply the m_nDisplayMode bit MKI_DISPLAYMODE_SCALED_WIDTH.

USE_CONFINED

Apply the m_nDisplayMode bit MKI_DISPLAYMODE_CONFINED.

USE_NOGEO

Apply the m_nDisplayMode bit MKI_DISPLAYMODE_NOGEO.

USE_ADAPTANGLE

Apply the m_nDisplayMode bit MKI_DISPLAYMODE_ADAPT_ANGLE.

USE_SCALEDLENGTH

Apply the m_nDisplayMode bit MKI_DISPLAYMODE_SCALED_LENGTH.

USE_ADAPTSCALE

Apply the m_nDisplayMode bit MKI_DISPLAYMODE_ADAPT_SCALE.

USE_NOHIDE

Apply the m_nDisplayMode bit MKI_DISPLAYMODE_NOHIDE.

USE_HIDELAYERS

Apply the hidden layer information m_afHideLayers.