SymbolMacro Method (Insert3D)

In This Topic

Places objects from symbol macro into layout space.

Syntax

C#
C++/CLI

public StorableObject[] SymbolMacro( 
   string strEMSFileName,
   int nVariant,
   Placement3D oParent,
   Matrix3D oMatrix,
   Insert3D.MoveKind nMoveCondition,
   WindowMacro.Enums.NumerationMode nNumerationMode
)

public:
array<StorableObject^>^ SymbolMacro( 
   String^ strEMSFileName,
   int nVariant,
   Placement3D^ oParent,
   Matrix3D oMatrix,
   Insert3D.MoveKind nMoveCondition,
   WindowMacro.Enums.NumerationMode nNumerationMode
)

Parameters

strEMSFileName: Full file name of the SymbolMacro file (.ems) to be placed.
nVariant: Index of the macro variant to be placed (0 based).
oParent: Object from EPLAN project to which top most objects from macro will be assigned.
oMatrix: Transformation by which objects from macro will be multiplied.
nMoveCondition: Determines if the macro will be placed with absolute coordinates or relatively to its original position
nNumerationMode: numeration mode

Return Value

Inserted placements

Exceptions

Exception	Description
ArgumentException	Thrown in case of invalid parameters..
ArgumentNullException	Null was set to a parameter.
Eplan.EplApi.Base.BaseException	An error occurred during inserting the macro. Please refer to the error message.

Remarks

In same cases after inserting 3d macro the absolute transformation of inserted object can be different then the one determined in parameters. This situation can happen when in macro user handle is defined and it is not located in origin of first object from the macro. In this case all objects from macro are placed relative to this user defined handle which is located in given position.

Reference

Insert3D Class
Insert3D Members

Send Feedback