CoordinateSpaceTree.LookUpName Method

CoordinateSpaceTree LookUpName Method

Cognex VisionPro 9.22

Look up the given SpaceName in this tree and, if found, returns an appropriately formatted copy of the name.

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

Syntax

public string LookUpName(
	string spaceName,
	SpaceTreePathnameConstants pathnameFormat
)

public string LookUpName(
	string spaceName,
	SpaceTreePathnameConstants pathnameFormat
)

Public Function LookUpName ( 
	spaceName As String,
	pathnameFormat As SpaceTreePathnameConstants
) As String

Public Function LookUpName ( 
	spaceName As String,
	pathnameFormat As SpaceTreePathnameConstants
) As String

public:
String^ LookUpName(
	String^ spaceName, 
	SpaceTreePathnameConstants pathnameFormat
)

public:
String^ LookUpName(
	String^ spaceName, 
	SpaceTreePathnameConstants pathnameFormat
)

Parameters

spaceName: Type: System String
A valid nonqualified or fully-qualified space name to find in this coordinate space tree.

pathnameFormat: Type: Cognex.Vision SpaceTreePathnameConstants
A SpaceTreePathnameConstants value that indicates how the returned name should be formatted.

Return Value

Type: String

The formatted space name.

Exceptions

Exception	Condition
ArgumentException	pathnameFormat value is not a member of SpaceTreePathnameConstants.
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.
SpaceTreeException	spaceName does not exist in this tree.

Remarks

Looks up the given coordinate space name in this tree and, if found, returns an appropriately formatted copy of the name. You can use LookUpName to verify that a given space name is valid and exists in the tree. This method is similar to FindNames, except that it requires that only one instance of the name exist in the tree.