RecognizerContext.BackgroundRecognize Method

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

Definition

Visual Basic .NET	Public Sub BackgroundRecognize( _ ByVal customData As Object _ )
C#	public void BackgroundRecognize( object customData );
Managed C++	public: void BackgroundRecognize( Object *customData );

Parameters

customData

System.Object. 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).

Exceptions

COMException :
ObjectDisposedException : The RecognizerContext object is disposed.

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.

Examples

See Also

• RecognizerContext.BackgroundRecognizeWithAlternates Method
• ExtendedProperty.Data Property
• RecognitionAlternate Class