CogCoordinateSpaceTree.CopySubtree Method

CogCoordinateSpaceTree CopySubtree Method

Cognex VisionPro 9.21

Return a copy of the subtree rooted at SpaceName.

Namespace: Cognex.VisionPro
Assembly: Cognex.VisionPro.Core (in Cognex.VisionPro.Core.dll) Version: 83.0.0.0

Syntax

public CogCoordinateSpaceTree CopySubtree(
	string spaceName
)

public CogCoordinateSpaceTree CopySubtree(
	string spaceName
)

Public Function CopySubtree ( 
	spaceName As String
) As CogCoordinateSpaceTree

Public Function CopySubtree ( 
	spaceName As String
) As CogCoordinateSpaceTree

public:
CogCoordinateSpaceTree^ CopySubtree(
	String^ spaceName
)

public:
CogCoordinateSpaceTree^ CopySubtree(
	String^ spaceName
)

spaceName: Type: System String
A valid nonqualified or fully-qualified space name that indicates the root space of the subtree to copy.

The copied coordinate space subtree.

Exceptions

Exception	Condition
CogSpaceTreeInvalidNameSyntaxException	spaceName value is not a legal space name.
CogSpaceTreeNotUniqueException	spaceName is a nonqualified space name and more than one instance of it exists in this tree.

Remarks

Returns a copy of the subtree rooted at the given space name. CopySubtree(String) does not perform a deep copy of trees embedded using the AddTree(String, CogCoordinateSpaceTree, ICogTransform2D, Boolean, CogAddSpaceConstants) method. Instead, it creates an additional reference.