InkRecognizerCollection.GetPriorityInkRecognizer Method (InkRecognizerCapabilities)
Gets the first recognizer in the collection that supports the specified capabilities.
Namespace: System.Windows.Ink
Assembly: IAWinFX (in IAWinFX.dll)
Syntax
'Declaration
Public Function GetPriorityInkRecognizer ( _
capabilities As InkRecognizerCapabilities _
) As InkRecognizer
'Usage
Dim instance As InkRecognizerCollection
Dim capabilities As InkRecognizerCapabilities
Dim returnValue As InkRecognizer
returnValue = instance.GetPriorityInkRecognizer(capabilities)
public InkRecognizer GetPriorityInkRecognizer(
InkRecognizerCapabilities capabilities
)
public:
InkRecognizer^ GetPriorityInkRecognizer(
InkRecognizerCapabilities capabilities
)
public function GetPriorityInkRecognizer(
capabilities : InkRecognizerCapabilities
) : InkRecognizer
Parameters
capabilities
Type: System.Windows.Ink.InkRecognizerCapabilitiesThe capabilities that the recognizer supports.
Return Value
Type: System.Windows.Ink.InkRecognizer
The first InkRecognizer in the collection that supports the specified InkRecognizerCapabilities, or nulla null reference (Nothing in Visual Basic) reference (Nothing in Visual Basic) if the collection contains no such recognizer.
Remarks
The GetPriorityInkRecognizer method only checks for a recognizer that supports the default locale. If there is a recognizer installed that supports the specified capabilities, but not the default locale, GetPriorityInkRecognizer returns nulla null reference (Nothing in Visual Basic).
Examples
The following example gets the first InkRecognizer from the InkRecognizerCollection, theInkRecognizers, that supports boxed input.
' Get the first recognizer from the InkRecognizerCollection that supports
' boxed input.
Dim theFirstBoxedInputInkRecognizer As InkRecognizer = _
theInkRecognizers.GetPriorityInkRecognizer(InkRecognizerCapabilities.BoxedInput)
// Get the first recognizer from the InkRecognizerCollection that supports
// boxed input.
InkRecognizer theFirstBoxedInputInkRecognizer =
theInkRecognizers.GetPriorityInkRecognizer(
InkRecognizerCapabilities.BoxedInput);
Platforms
Windows 7, Windows Vista, Windows XP SP2, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003
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
InkRecognizerCollection Members