RecognitionAlternate.AlternatesWithConstantPropertyValues Method
Returns a RecognitionAlternates collection that is made of a division of the RecognitionAlternate object on which this method is called.
Namespace: Microsoft.Ink
Assembly: Microsoft.Ink (in Microsoft.Ink.dll)
Syntax
'Declaration
Public Function AlternatesWithConstantPropertyValues ( _
g As Guid _
) As RecognitionAlternates
'Usage
Dim instance As RecognitionAlternate
Dim g As Guid
Dim returnValue As RecognitionAlternates
returnValue = instance.AlternatesWithConstantPropertyValues(g)
public RecognitionAlternates AlternatesWithConstantPropertyValues(
Guid g
)
public:
RecognitionAlternates^ AlternatesWithConstantPropertyValues(
Guid g
)
public function AlternatesWithConstantPropertyValues(
g : Guid
) : RecognitionAlternates
Parameters
g
Type: System.GuidThe Guid identifier for the RecognitionProperty type for which each returned RecognitionAlternate in the collection has the same constant value.
Return Value
Type: Microsoft.Ink.RecognitionAlternates
Returns a RecognitionAlternates collection that is made of a division of the RecognitionAlternate object on which this method is called.
Remarks
Each RecognitionAlternate object in the RecognitionAlternates collection contains adjacent recognition segments, which have the same property value for the g property passed into the method.
For example, you can return alternates that divide the original alternate by:
Level of confidence boundaries—whether strong, intermediate, or poor—in the recognition result.
Line boundaries.
recognition segment boundaries.
For a complete list of property types, see the RecognitionProperty object.
Note
The recognizer determines the segmentation of strokes into the recognition segments. Some recognition segments, such as spaces, may correspond to an empty Strokes collection.
Note
The recognizer determines the ordering of the recognition segments. Therefore, adjacent recognition segments may be based on the order in which the ink was drawn or based on location, such as whether ink is positioned left-to-right, positioned top-to-bottom, and so on.
The ConfidenceAlternates property is an alternative to the AlternatesWithConstantPropertyValues method, where the ConfidenceLevel property is the RecognitionProperty that separates the alternates in the returned RecognitionAlternates collection.
The LineAlternates property is an alternative to the AlternatesWithConstantPropertyValues method, where the LineNumber property is the RecognitionProperty that separates the alternates in the returned RecognitionAlternates collection.
Note
The AlternatesWithConstantPropertyValues method, the LineAlternates property, and the ConfidenceAlternates property of the RecognitionAlternate object function differently than the GetAlternatesFromSelection method of the RecognitionResult object. The GetAlternatesFromSelection method returns a RecognitionAlternates collection for the requested segments of the recognition result.
Platforms
Windows 7, Windows Vista, Windows Server 2008 R2, Windows Server 2008
The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Version Information
.NET Framework
Supported in: 3.0
See Also
Reference
RecognitionAlternate.ConfidenceAlternates
RecognitionAlternate.LineAlternates