CopyShapeTo Method

In This Topic

Copy control path shape to another control path.

Syntax

public void CopyShapeTo( 
   IControlPath sourcePath,
   IControlPath targetPath,
   IControlPoint sourceStartPoint,
   IControlPoint targetStartPoint
)

Parameters

sourcePath: Source control path occurrence which shape will be copy to targetPath occurrence.
targetPath: Target control path occurrence to apply shape from sourcePath occurrence.
sourceStartPoint: Start point of the sourcePath from which the shape will be taken.
targetStartPoint: Start point of the targetPath from which the shape will be applied.

Exceptions

Exception	Description
EPLAN.Harness.API.Exceptions.ArgumentNullException
EPLAN.Harness.API.Exceptions.ArgumentException	Thrown when the supplied occurrence cannot be used. E.g. path without any inner control points, path passing through leading part, etc.
EPLAN.Harness.API.Exceptions.HpdApiNotInitializedException	Api is not in an initialized state. You can get current state from EPLAN.Harness.API.Studio.Status property. If API is uninitialized, you can initialize it by calling EPLAN.Harness.API.Studio.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.FileClosedException	This file is not opened.
EPLAN.Harness.API.Exceptions.FileOpenedAsReadOnlyException	You can not perform this action on a document opened as read only.

Example

This example shows how to copy shape of a bundle to a wire.

// Open a designer.
Designer designer = ...
designer.Open(false, false);

// Find the source bundle.
IOccBundle bundle = designer.GetAllOccurrences().OfType<IOccBundle>().FirstOrDefault(b => b.Name.Value == "sourceBundle");

// Find the target wire.
IOccWire wire = designer.GetAllOccurrences().OfType<IOccWire>().FirstOrDefault(w => w.Name.Value == "targetWire");

designer.CopyShapeTo(bundle, wire);

Reference

Designer Class
Designer Members

Send Feedback