CogCoordinateSpaceTree.ResolvePartialName Method

CogCoordinateSpaceTree 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.VisionPro
Assembly: Cognex.VisionPro.Core (in Cognex.VisionPro.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 it is a partially-qualified coordinate space name.

nameToResolve: Type: System String
The coordinate space name to resolve. If . is a partially-qualified name, ResolvePartialName(String, String) resolves it by using the startingSpaceName value. Otherwise, ResolvePartialName(String, String) ignores startingSpaceName and returns a copy of the original name.

Return Value

Type: String

nameToResolve as a nonqualified or fully-qualified pathname.

Exceptions

Exception	Condition
CogSpaceTreeInvalidNameSyntaxException	startingSpaceName value is not a legal space name.
CogSpaceTreeNotUniqueException	startingSpaceName is a nonqualified space name and more than one instance of it exists 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 is the only method that can accept partially-qualified space names.