CoordinateSpaceTree.CopySubtree Method

CoordinateSpaceTree CopySubtree Method

Cognex VisionPro 9.21 SR1

Return a copy of the subtree rooted at SpaceName.

Namespace: Cognex.Vision
Assembly: Cognex.Vision.Core.Net (in Cognex.Vision.Core.Net.dll) Version: 9.21.1.1

Syntax

public CoordinateSpaceTree CopySubtree(
	string spaceName
)

public CoordinateSpaceTree CopySubtree(
	string spaceName
)

Public Function CopySubtree ( 
	spaceName As String
) As CoordinateSpaceTree

Public Function CopySubtree ( 
	spaceName As String
) As CoordinateSpaceTree

public:
CoordinateSpaceTree^ CopySubtree(
	String^ spaceName
)

public:
CoordinateSpaceTree^ CopySubtree(
	String^ spaceName
)

Parameters

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

Return Value

Type: CoordinateSpaceTree

The copied coordinate space subtree.

Exceptions

Exception	Condition
SpaceTreeException	spaceName value is not a legal space name.
SpaceTreeException	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 does not perform a deep copy of trees embedded using the AddTree method. Instead, it creates an additional reference.