RecognizerContext.PrefixText, propriété

Article
11/05/2008

Mise à jour : November 2007

Obtient ou définit les caractères qui précèdent la collection Strokes dans l'objet RecognizerContext.

Espace de noms : Microsoft.Ink
Assembly : Microsoft.Ink (dans Microsoft.Ink.dll)

Syntaxe

'Déclaration
Public Property PrefixText As String
'Utilisation
Dim instance As RecognizerContext
Dim value As String

value = instance.PrefixText

instance.PrefixText = value

public string PrefixText { get; set; }

public:
property String^ PrefixText {
    String^ get ();
    void set (String^ value);
}

/** @property */
public String get_PrefixText()
/** @property */
public  void set_PrefixText(String value)

public function get PrefixText () : String
public function set PrefixText (value : String)

Valeur de propriété

Type : System.String
Caractères qui précèdent la collection Strokes dans l'objet RecognizerContext. Doit être inférieur à 1 000 caractères.

Notes

Le préfixe permet d'améliorer les résultats de reconnaissance en fournissant au module de reconnaissance davantage de contexte concernant de l'écriture manuscrite.

La définition de la propriété PrefixText aboutit uniquement si la propriété Strokes a la valeur nullune référence null (Nothing en Visual Basic). Vous devez définir la propriété PrefixText avant d'attacher une collection Strokes à la propriété Strokes du RecognizerContext, ou affecter la valeur nullune référence null (Nothing en Visual Basic) à la propriété Strokes, puis définir la propriété PrefixText.

Remarque :
Si vous utilisez cette dernière méthode, vous devrez probablement attacher de nouveau la collection Strokes à la propriété Strokes de l'objet RecognizerContext.

Lorsque vous affectez la valeur null à la propriété PrefixText, le texte du préfixe est supprimé de l'objet RecognizerContext.

Le texte du préfixe est ignoré sauf si vous avez défini les indicateurs Coerce et WordModeRecognitionModes dans la propriété RecognitionFlags.

La propriété SuffixText obtient ou définit les caractères qui suivent les traits dans le contexte de reconnaissance et permet également d'améliorer le résultat de reconnaissance.

Si votre application fournit une interface de correction lors de la conversion de l'entrée manuscrite en texte, elle peut autoriser l'utilisateur à sélectionner des caractères dans un mot et à utiliser le stylet pour générer des caractères de remplacement. Votre application peut utiliser les propriétés PrefixText et SuffixText pour améliorer la reconnaissance de la nouvelle entrée manuscrite.

Exemples

Cet exemple C# retourne le texte du préfixe de l'objet RecognizerContext, theRecognizerContext.

string thePrefixText = theRecognizerContext.PrefixText;

Cet exemple Microsoft® Visual Basic® .NET retourne le texte du préfixe de l'objet RecognizerContext, theRecognizerContext.

Dim thePrefixText As String = theRecognizerContext.PrefixText

Plateformes

Windows Vista

Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.