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

C++ Syntax

class MKI_MULTI_TEXTSTANDARD : public MKI_MULTI_BASE

{

  public:

  MKI_FONTDEF m_cTextFont;

  double m_dCharDistance,

         m_dTabDistance,

         m_dLineDistance,

         m_dHeight,

         m_dCompression,

         m_dRotation,

         m_dDistortion;

  MKI_POINT m_cPointUnits;

  __int32 m_nTextMode,

          m_nTextOrder,

          m_nDisplayMode,

          m_nSystem;

  void

  Init( void ); New in Version 2023.1

  void

  Fill(

 MKI_CONST_TEXTSTANDARD_REF f_rData ); New in Version 2023.1

  void

  Apply(

 MKI_TEXTSTANDARD_REF f_rData,

 bool f_fCopyAll ) const; New in Version 2023.1

};

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

Element Description

m_cTextFont

[MKI_FONTDEF] Description of the font to be used for this text.

m_dCharDistance

[double] The value CharDistance determines the gap between two characters. This gap is stated relative to the font size. A value of 0.1 at a font size of 10pt will result in a character gap of 1pt. Allowed values are -10.0 to +10.0. The default value for TrueType and device fonts should be 0.0, for internal fonts 0.125.

m_dTabDistance

[double] The value TabDistance determines the distance between two tabulators. This distance is stated relative to the font size. A value of 4.0 at a font size of 5 mm will result in a tabulator distance of 20 mm. Allowed values are -100.0 to 100.0. The default value is 4.0.

m_dLineDistance

[double] The value LineDistance determines the offset between two lines of text, measured from baseline to baseline. This offset is stated relative to the font size. A value of 1.2 at a font size of 10pt will lead to a line offset of 12pt. Allowed values are -10.0 to 10.0. The default value is 1.0.

m_dHeight

[double] Height of the text in [mm].

m_dCompression Changed in Version 6.41

[double] Horizontal compression of the text relative to 1.0

m_dRotation

[double] Rotation of the complete text in [rad].

m_dDistortion

[double] Distortion of the complete text in [rad].

m_cPointUnits New in Version 2023.1

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

m_nTextMode

[__int32] The value TextMode states the position of the text relative to the insertion point (see MKI_TEXTMODE_*). Block mode is not supported.

m_nTextOrder

[__int32] The value TextOrder defines the reading order of the text, i.e. it determines the direction in which the characters are placed (see MKI_TEXTORDER_*).

m_nDisplayMode New in Version 6.20

[__int32] Bit-wise OR combination of some flags indicating the display mode for instance / clipping surfaces / extended object. Possible values are (see MKI_DISPLAYMODE_*):

MKI_DISPLAYMODE_ADAPT_ANGLE

MKI_DISPLAYMODE_ADAPT_SCALE

m_nSystem New in Version 2017.0

[__int32] Index of the coordinate system the text shall be based on.

Comment

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

USE_FONT

Apply m_cTextFont.

USE_CHARDISTANCE

Apply m_dCharDistance.

USE_TABDISTANCE

Apply m_dTabDistance.

USE_LINEDISTANCE

Apply m_dLineDistance.

USE_HEIGHT

Apply m_dHeight.

USE_COMPRESSION

Apply m_dCompression.

USE_ROTATION

Apply m_dRotation.

USE_DISTORTION

Apply m_dDistortion.

USE_XPOS

Apply m_cPosition.x.

USE_YPOS

Apply m_cPosition.y.

USE_TEXTMODE

Apply m_nTextMode.

USE_ORDER

Apply m_nTextOrder.

USE_ADAPTANGLE

Apply the m_nDisplayMode bit MKI_DISPLAYMODE_ADAPT_ANGLE.

USE_VERTICAL

Apply m_nTextVertical.

USE_SYSTEM

Apply m_nSystem.

USE_ADAPTSCALE

Apply the m_nDisplayMode bit MKI_DISPLAYMODE_ADAPT_SCALE.