RecognizerGuide Structure

Article
12/12/2007

Represents the area that the Recognizer object uses and in which ink can be drawn. The area is known as the recognizer guide.

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

Syntax

'Declaration
Public Structure RecognizerGuide
'Usage
Dim instance As RecognizerGuide

public struct RecognizerGuide

public value class RecognizerGuide

public final class RecognizerGuide extends ValueType

Not applicable.

Remarks

The recognizer guide can consist of rows and columns, and gives the recognizer a better context in which to perform recognition. For example, you can draw horizontal lines on a user's screen, almost like a ruled piece of paper, that show where inking should occur (this type of guide would consist only of rows, and no columns). If a user writes on the lines, instead of some arbitrary space, recognition accuracy improves. For illustrations of recognizer guides, see Ink Recognition.

Letters such as "t" and "I" are more easily recognized when a guide is used to give context to the ink.

The guide specifies the boundaries of the ink in ink space coordinates. The DrawnBox property can define a box which is the same size as or smaller than the box defined by the WritingBox property. This allows for disparate writing styles. If the user writes outside the DrawnBox but within the WritingBox, the Recognizer object uses all of the ink to aid in recognition.

If the application has drawn guidelines on the screen on which the user is expected to write, the application should set the values of the properties of the recognizer guide to inform the recognizer. These properties are for the recognizer's use only. Setting them does not, by itself, draw visual clues on the display. The application or the control draws the visual clues.

In addition to drawing lines, or rules, on the screen that show users where to write, it is also possible to draw cells on the screen in which characters or words are written. This is called boxed input and is useful with some East Asian languages. To determine if the recognizer is capable of boxed input, call the Capabilities property of the Recognizer object.

By default, there is no guide. A default guide has all property values set to 0. You must use the properties of this object to set the guide.

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

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