Cog3DCoordinateSpaceTree.LookUpName Method

Cog3DCoordinateSpaceTree LookUpName Method

Cognex VisionPro

Looks up the given spaceName in this tree and returns an appropriately formatted copy of the name.

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

Syntax

C++

Copy to Clipboard Print

public string LookUpName(
	string spaceName,
	CogSpaceTreePathnameConstants pathnameFormat
)

public string LookUpName(
	string spaceName,
	CogSpaceTreePathnameConstants pathnameFormat
)

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

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

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

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

Parameters

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

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

Return Value

Type: String

The formatted space name.

Exceptions

Exception	Condition
ArgumentOutOfRangeException	The pathnameFormat value is not a member of CogSpaceTreePathnameConstants.
CogSpaceTreeInvalidNameSyntaxException	spaceName is not a legal space name.
CogSpaceTreeNameNotUniqueException	spaceName is a nonqualified space name and more than one instance of it exists in this tree.
CogSpaceTreeNameNotInTreeException	spaceName does not exist in this tree.

Remarks

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