Recognizer.Capabilities Property
Gets the capabilities of the Recognizer object.
Namespace: Microsoft.Ink
Assembly: Microsoft.Ink (in Microsoft.Ink.dll)
Syntax
'Declaration
Public ReadOnly Property Capabilities As RecognizerCapabilities
'Usage
Dim instance As Recognizer
Dim value As RecognizerCapabilities
value = instance.Capabilities
public RecognizerCapabilities Capabilities { get; }
public:
property RecognizerCapabilities Capabilities {
RecognizerCapabilities get ();
}
public function get Capabilities () : RecognizerCapabilities
Property Value
Type: Microsoft.Ink.RecognizerCapabilities
Values that define the capabilities of the recognizer.
Remarks
A recognizer's capabilities are defined in the RecognizerCapabilities enumeration, and they include whether the recognizer supports character Autocomplete; whether it supports free, lined, or boxed input; and so on. For a complete list of recognizer capabilities, see the RecognizerCapabilities enumeration.
To determine if a recognizer has a particular capability, use a bitwise comparison operator to check for that capability. For more information about how a bitwise comparison works, see the And Operator.
Examples
In this example, the first Recognizer that supports German (language ID 1031), the RecognizerCapabilities capability LinedInput, and ConfidenceLevel is assigned to the selected Recognizer object variable.
Dim selectedRecognizer As Recognizer = Nothing
Dim allRecognizers As Recognizers = New Recognizers()
For Each oneReco As Recognizer In allRecognizers
' if we haven't found the one we want yet
If Not selectedRecognizer Is Nothing Then
' if supports LinedInput
If (oneReco.Capabilities And RecognizerCapabilities.LinedInput) <> 0 Then
For Each langID As Short In oneReco.Languages
' if supports German (1031)
If langID = 1031 Then
For Each propertyGuid As Guid In oneReco.SupportedProperties
' if supports ConfidenceLevel
If propertyGuid = RecognitionProperty.ConfidenceLevel Then
' assign selected
selectedRecognizer = oneReco
End If
Next
End If
Next
End If
End If
Next
Recognizer selectedRecognizer = null;
Recognizers allRecognizers = new Recognizers();
foreach (Recognizer oneReco in allRecognizers)
{
// if we haven't found the one we want yet
if (null == selectedRecognizer)
{
// if supports LinedInput
if ((oneReco.Capabilities & RecognizerCapabilities.LinedInput) != 0)
{
foreach (short langID in oneReco.Languages)
{
// if supports German (1031)
if (langID == 1031)
{
foreach (Guid propertyGuid in oneReco.SupportedProperties)
{
// if supports ConfidenceLevel
if (propertyGuid == RecognitionProperty.ConfidenceLevel)
{
// assign selected
selectedRecognizer = oneReco;
}
}
}
}
}
}
}
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