RecognizerContext.CharacterAutoCompletion Property

  • Article

RecognizerContext.CharacterAutoCompletion Property

Gets or sets the character Autocomplete mode, which determines when characters or words are recognized.

Definition

Visual Basic .NET Public Property CharacterAutoCompletion As RecognizerCharacterAutoCompletionMode
C# public RecognizerCharacterAutoCompletionMode CharacterAutoCompletion { get; set; }
Managed C++ public: __property RecognizerCharacterAutoCompletionMode* get_CharacterAutoCompletion();
public: __property void set_CharacterAutoCompletion(RecognizerCharacterAutoCompletionMode*);

Property Value

Microsoft.Ink.RecognizerCharacterAutoCompletionMode. The character Autocomplete mode, which determines when characters or words are recognized.

This property is read/write. This property has no default value.

Full0 Specifies recognition occurs as if all strokes have been input.
Random2 Specifies recognition occurs on partial input. The order of the strokes can be arbitrary.
Prefix1 Specifies recognition occurs on partial input. The order of the strokes must conform to the rules of the language.

Exceptions

ObjectDisposedException Leave Site:

Remarks

Recognition can occur in Full mode (all strokes have been inputted), Partial mode (partial input in specific order), or Random mode (partial input in random order).

For a list of the character Autocomplete mode values that you can use, see the RecognizerCharacterAutoCompletionMode enumeration type.

You cannot turn character Autocomplete off after it is set.

You must set the Guide property before using this property.

Some recognizers do not support character Autocomplete. The RecognizerCapabilities enumeration contains flags for features a recognizer can support. You can determine if the recognizer supports character Autocomplete by checking the value of the Recognizer object's Capabilities property.

Examples

[C#]

This C# example sets the CharacterAutoCompletion property of the RecognizerContext, theRecognizerContext, to Random.

theRecognizerContext.CharacterAutoCompletion =
    RecognizerCharacterAutoCompletionMode.Random;

[Visual Basic .NET]

This Microsoft® Visual Basic® .NET example sets the CharacterAutoCompletion property of the RecognizerContext, theRecognizerContext, to Random.

theRecognizerContext.CharacterAutoCompletion = _
    RecognizerCharacterAutoCompletionMode.Random

See Also