Cog3DCoordinateSpaceTree FindNames Method Cognex VisionPro 9.7
Find the given spaceName in this tree and return a collection containing the fully-qualified pathname(s) that are found. The collection may contain zero, one, or more items.

Namespace: Cognex.VisionPro3D
Assembly: Cognex.VisionPro3D.Core (in Cognex.VisionPro3D.Core.dll) Version: 73.0.0.0
Syntax

public List<string> FindNames(
	string spaceName
)

Parameters

spaceName
Type: System String

A valid nonqualified or fully-qualified space name to find in this coordinate space tree.

Return Value

Type: List String 

A collection of space names; or an empty collection if the given name does not exist in the tree.

Exceptions

ExceptionCondition
CogSpaceTreeInvalidNameSyntaxException

spaceName is not a legal space name.

Remarks

Finds the given coordinate space name in this tree and returns a collection containing zero or more fully-qualified pathnames that are found. The returned collection contains more than one space name only if the given spaceName is nonqualified and exists at multiple locations within the coordinate space tree.

You can use this method to determine if a space name is valid and exists in this tree, or to convert a nonqualified space name to one or more fully-qualified space names. This method is similar to LookUpName(String, CogSpaceTreePathnameConstants), but it does not generate an error if the given space name exists more than once in the tree, or does not exist in the tree at all.

See Also