RecognizerContext.BackgroundRecognize Method (Object)

Article
12/12/2007

Causes the Recognizer object to recognize the associated Strokes collection and raise a Recognition event, with associated application data, when recognition is complete.

Namespace: Microsoft.Ink
Assembly: Microsoft.Ink (in microsoft.ink.dll)

Syntax

'Declaration
Public Sub BackgroundRecognize ( _
    customData As Object _
)
'Usage
Dim instance As RecognizerContext
Dim customData As Object

instance.BackgroundRecognize(customData)

public void BackgroundRecognize (
    Object customData
)

public:
void BackgroundRecognize (
    Object^ customData
)

public void BackgroundRecognize (
    Object customData
)

public function BackgroundRecognize (
    customData : Object
)

Not applicable.

Parameters

customData
Any application-defined data that is available to the application in the Recognition event. The default value is null (Nothing in Microsoft® Visual Basic® .NET).

Remarks

This method specifies that ink recognition is performed asynchronously. To recognize ink synchronously, call the RecognizerContext.Recognize method.

This method recognizes only the best result string. This method does not create RecognitionAlternate objects. To perform recognition that creates a list of available alternates, call the BackgroundRecognizeWithAlternates method.

The Recognition event is not raised if the recognizer does not recognize anything.

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

Share via