API Help
Eplan.EplApi.DataModel Namespace / Function Class / PlaceFunctionalMacro Method
A page to insert the macro on.
Insertion point of the macro.
A macro file name. This parameter is ignored if a macro is assigned to the function in its article data.
Representation type that should be taken from the macro.
A variant that should be taken from the macro. Possible values are 0 through 15 (they map to A through P values in EPLAN P8 GUI).

In This Topic
    PlaceFunctionalMacro Method
    In This Topic
    Places a macro assigned to this function together with a special symbol configured in settings. The symbol placed has 'Functional' representation type and the macro is converted to graphics after insertion. If no macro is assigned to the function in its article data (ARTICLE_GROUPSYMBOLMACRO property), the macro specified by the third parameter ('strMacroFileName') will be inserted.
    Syntax

    Parameters

    oPage
    A page to insert the macro on.
    pntLocation
    Insertion point of the macro.
    strMacroFileName
    A macro file name. This parameter is ignored if a macro is assigned to the function in its article data.
    nRepType
    Representation type that should be taken from the macro.
    nVariant
    A variant that should be taken from the macro. Possible values are 0 through 15 (they map to A through P values in EPLAN P8 GUI).

    Return Value

    Returns an array of placements inserted onto the page.
    Exceptions
    ExceptionDescription
    Thrown when a functional macro cannot be created
    Remarks
    Variant of the macro (either the one from article or the one specified by the 'strMacroFileName' parameter) is determined by the 'nRepType' and 'nVariant' parameters. If the specified variant doesn't exist in the macro, an exception is thrown.
    See Also