Eplan Platform API
Eplan.EplApi.DataModel.E3D Namespace / Placement3D Class / AddMatePersistent Method
Mate which copy will be added to this placement. Can't be NULL.

In This Topic
    AddMatePersistent Method
    In This Topic
    Add copy of a mate to a Placement3D.
    Syntax
    public void AddMatePersistent( 
   Mate pCustomMate
)
    public:
void AddMatePersistent( 
   Mate^ pCustomMate
)

    Parameters

    Parameter NameDescription
    pCustomMateMate which copy will be added to this placement. Can't be NULL.
    Exceptions
    ExceptionDescription
    System.ArgumentNullExceptionThrown when parameter is NULL.
    Remarks
    The method is used to add user-defined mate to a Placement3D.
    During adding a source mate, there is done some validation to keep following rules:
    • If mate's logical type is UserGripPoint or UserGripPointExt, its name has to be 'G1'.
    • UserGripPoint is the standard handle and gets always standard matching names.
    • To prevent snapping on poles or holder of a bus bar system, most of source mates get the suffix '-#P#H' for matching mate names
    • If there are no user-defined persistent mates, Eplan creates some transient mates.
    For target mates, there are no limitation with defining the mate name and the matching names.
    See Also

    Reference

    Placement3D Class
    Placement3D Members

     

     

    Eplan API, 05.05.2026, © by EPLAN GmbH & Co. KG. All rights reserved.

    Use the Eplan Global Support Portal for feedback and support