Cog3DCoordinateSpaceTree.ResolvePartialName Method

Cog3DCoordinateSpaceTree ResolvePartialName Method

Cognex VisionPro 9.7

Use the given startingSpaceName to resolve any ambiguity in nameToResolve, and return a name suitable for lookup in this tree. Note that a partial name, like ".", is ambiguous without a specified starting space.

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

Syntax

C++

Copy to Clipboard Print

public string ResolvePartialName(
	string startingSpaceName,
	string nameToResolve
)

public string ResolvePartialName(
	string startingSpaceName,
	string nameToResolve
)

Public Function ResolvePartialName ( 
	startingSpaceName As String,
	nameToResolve As String
) As String

Public Function ResolvePartialName ( 
	startingSpaceName As String,
	nameToResolve As String
) As String

public:
String^ ResolvePartialName(
	String^ startingSpaceName, 
	String^ nameToResolve
)

public:
String^ ResolvePartialName(
	String^ startingSpaceName, 
	String^ nameToResolve
)

Parameters

startingSpaceName: Type: System String
The starting space name used to resolve nameToResolve, if nameToResolve is a partially-qualified coordinate space name.

nameToResolve: Type: System String
The coordinate space name to resolve. If nameToResolve is a partially-qualified name, this method resolves it using the startingSpaceName value. Otherwise, the startingSpaceName value is ignored and the original nameToResolve is returned.

Return Value

Type: String

nameToResolve as a nonqualified or fully-qualified pathname.

Exceptions

Exception	Condition
CogSpaceTreeInvalidNameSyntaxException	startingSpaceName is not a legal space name.
CogSpaceTreeNameNotUniqueException	startingSpaceName is a nonqualified space name and more than one instance of it exists in this tree.
CogSpaceTreeNameNotInTreeException	startingSpaceName does not exist in this tree.

Remarks

Uses the given startingSpaceName to resolve any ambiguity in nameToResolve, and returns a name suitable for lookup in this tree. Note that a partial name, such as ".", is ambiguous without a specified starting space name.

This method is the only method of the coordinate space tree that can accept partially-qualified space names. It will never return a partially-qualified space name, but it may return a space name that is not unique, or one that does not exist in this space tree.