MKI_MULTI_INSTANCE (Multi-Entity Editing Classes) Renamed and changed in Version 2023.1

C++ Syntax

class MKI_MULTI_INSTANCE : public MKI_MULTI_BASE

{

  public:

  MKI_LIBRARYNAME m_szLibraryName;

  MKI_BLOCKNAME m_szBlockName;

  MKI_COMMENTLONG m_szComment;

  MKI_VECTOR m_cScaling;

  double m_dRotation,

         m_dDistortion,

  MKI_POINT m_cPointUnits;

  __int32 m_nDisplayMode;

  bool m_fInitAttrib,

       m_fInitEmbed;

  void

  Init( void ); New in Version 2023.1

  void

  Fill(

 MKI_CONST_ENTITY_INSTANCE_PTR f_pInst ); New in Version 2023.1

  bool

  Apply(

 MKI_ENTITY_INSTANCE_PTR f_pInst,

 bool f_fCopyAll ) const; New in Version 2023.1

};

This structure contains instance properties to be edited in a dialog window.

Element Description

m_szLibraryName Changed in Version 2019.1

[MKI_LIBRARYNAME] Library name.

m_szBlockName Changed in Version 2019.1

[MKI_BLOCKNAME] Block name.

m_szComment Changed in Version 2019.1

[MKI_COMMENTLONG] Comment.

m_dScaling Changed in Version 6.41

[MKI_VECTOR] Horizontal and vertical scaling of the instance.

m_dRotation

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

m_dDistortion

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

m_cPointUnits New in Version 2023.1

[MKI_POINT] X and Y coordinate of the instance’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 instances. 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_EMBEDDED

MKI_DISPLAYMODE_ADAPT_SCALE

MKI_DISPLAYMODE_NOHIDE New in Version 2021.1

m_fInitAttrib New in Version 2010.1

[bool] If true, the local attributes of the instances will be re-initialized with the respective block's attributes.

m_fInitEmbed New in Version 2012.0

[bool] If true, the embedded block data will be reloaded (if possible).

Comment

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

USE_LIBRARYNAME

Apply the pen index m_szLibraryName.

USE_BLOCKNAME

Apply the filling mode m_szBlockName.

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_EMBEDDED

Apply the m_nDisplayMode bit MKI_DISPLAYMODE_EMBEDDED.

USE_COMMENT

Apply the comment m_szComment.

USE_ADAPTSCALE

Apply the m_nDisplayMode bit MKI_DISPLAYMODE_ADAPT_SCALE.

USE_NOHIDE

Apply the m_nDisplayMode bit MKI_DISPLAYMODE_NOHIDE.