Harness proD API Help
EPLAN.Harness.API.Projects.Documents Namespace / Designer Class / PlaceSplice Method / PlaceSplice(LibSplice,TransformProperty<LengthProperty>,ApiLinkType) Method
The part which is placed.
Position of the part in the workspace/workdesk.
Determines if part's accessories will be placed with part. Mandatory, Optional, both types or None accessories can be placed. This enum has the Flags attribute. Default is mandatory accessories.
Example
In This Topic
    PlaceSplice(LibSplice,TransformProperty<LengthProperty>,ApiLinkType) Method
    In This Topic
    Place a Splice on position.
    Syntax
    public IOccSplice PlaceSplice( 
   LibSplice part,
   TransformProperty<LengthProperty> transform,
   ApiLinkType linkType
)

    Parameters

    part
    The part which is placed.
    transform
    Position of the part in the workspace/workdesk.
    linkType
    Determines if part's accessories will be placed with part. Mandatory, Optional, both types or None accessories can be placed. This enum has the Flags attribute. Default is mandatory accessories.

    Return Value

    Placed occurrence.
    Exceptions
    ExceptionDescription
    EPLAN.Harness.API.Exceptions.FileClosedException This file is not opened.
    EPLAN.Harness.API.Exceptions.HpdApiNotInitializedExceptionApi is not in an initialized state. You can get current state from EPLAN.Harness.API.HpdApi.Status property. If API is uninitialized, you can initialize it by calling EPLAN.Harness.API.HpdApi.Init method. If API is in failed state, you can not resurrect it.
    EPLAN.Harness.API.Exceptions.ObjectInvalidException The object is in invalid state. Obtain a new one.
    EPLAN.Harness.API.Exceptions.IncorrectPartTypeExceptionThrown when the type of part can not be placed by the method.
    EPLAN.Harness.API.Exceptions.PartPlacementFailedExceptionThrown when placing this part failed.
    Remarks

    When linked type is not set no accessories of the part will be placed.

    Example
    This example shows how to place a Splice to workspace.
    /// Obtain workspace beforehand and open for writing.
Workspace workspace = ...
workspace.Open(false, false);

// Obtain a part from active library.
IEnumerable<BaseLibraryPart>parts = project.ActiveConnection.GetLibraryPartsByPartNumber("part1");
BaseLibraryPart part = parts.FirstOrDefault();

// Prepare position and rotation.
TransformProperty<LengthProperty> position = new TransformProperty<LengthProperty>(new LengthProperty(1, Unit.Meter), new LengthProperty(0, Unit.Meter), new LengthProperty(0, Unit.Meter));
TransformProperty<AngleProperty> rotation = new TransformProperty<AngleProperty>(new AngleProperty(0, Unit.Degree), new AngleProperty(0, Unit.Degree), new AngleProperty(0, Unit.Degree));

// Place a Splice with mandatory and optional accessories.
workspace.PlaceSplice(part as LibSplice, position, ApiLinkType.Optional | ApiLinkType.Mandatory);

// Or place a Splice without accessories.
workspace.PlaceSplice(part as LibSplice, position);
    See Also

    Reference

    Designer Class
    Designer Members
    Overload List
    BaseLibraryPart Class
    TransformProperty<T> Class
    ApiLinkType Enumeration

    Send Feedback