CoordinateSpaceTree.DeleteSubtree Method

CoordinateSpaceTree DeleteSubtree Method

Cognex VisionPro 9.20

Delete the subtree rooted at SpaceName. SpaceName and all of its children will be recursively removed from tree.

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

Syntax

public void DeleteSubtree(
	string spaceName
)

public void DeleteSubtree(
	string spaceName
)

Public Sub DeleteSubtree ( 
	spaceName As String
)

Public Sub DeleteSubtree ( 
	spaceName As String
)

public:
void DeleteSubtree(
	String^ spaceName
)

public:
void DeleteSubtree(
	String^ spaceName
)

Parameters

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

Exceptions

Exception	Condition
ArgumentException	spaceName cannot be the root space.
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

SubtreeDeleted Raised when a subtree is deleted from this tree.

Remarks

Deletes the subtree rooted at the given space name. All children of the space are recursively removed from the tree. If DeleteSubtree encounters the root node of a tree embedded using the AddTree method, it unlinks the embedded tree, and other clients of that tree can continue to use it.