Share via

RecognitionAlternate.AlternatesWithConstantPropertyValues Method

  • Article

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 RecognitionAlternates AlternatesWithConstantPropertyValues (
    Guid g
)

public function AlternatesWithConstantPropertyValues (
    g : Guid
) : RecognitionAlternates

Not applicable.

Parameters

Return Value

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 98, Windows Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

Version Information

.NET Framework

Supported in: 3.0

See Also

Reference

RecognitionAlternate Class
RecognitionAlternate Members
Microsoft.Ink Namespace
RecognitionAlternate.ConfidenceAlternates
RecognitionAlternate.LineAlternates
RecognitionAlternate.GetPropertyValue
RecognitionAlternates
RecognitionProperty
RecognitionResult
Microsoft.Ink.RecognitionResult.GetAlternatesFromSelection