RecognizerContext.Strokes, propriété

Article
11/05/2008

Mise à jour : November 2007

Obtient ou définit la collection Strokes associée à l'objet RecognizerContext.

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

Syntaxe

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

value = instance.Strokes

instance.Strokes = value

public Strokes Strokes { get; set; }

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

/** @property */
public Strokes get_Strokes()
/** @property */
public  void set_Strokes(Strokes value)

public function get Strokes () : Strokes
public function set Strokes (value : Strokes)

Valeur de propriété

Type : Microsoft.Ink.Strokes
Collection Strokes associée à l'objet RecognizerContext.

Notes

Vous devez assigner une collection Strokes à un objet RecognizerContext pour que l'objet RecognizerContext procède à la reconnaissance de l'écriture manuscrite. Cette propriété conserve la collection Strokes à partir de laquelle l'objet RecognizerContext crée l'objet RecognitionResult.

Vous pouvez définir la collection Strokes plusieurs fois. À chaque fois que vous définissez la collection Strokes, l'objet RecognizerContext est réinitialisé (l'entrée manuscrite ou les résultats sont supprimés et tous les appels antérieurs à la méthode EndInkInput sont ignorés), puis les nouveaux traits sont ajoutés.

Vous pouvez aussi affecter la valeur nullune référence null (Nothing en Visual Basic) à la collection Strokes, ce qui réinitialise également l'objet RecognizerContext. Lorsque le RecognizerContext est réinitialisé, il conserve le repère de reconnaissance, les éléments et toutes les autres propriétés définies précédemment.

Lorsque l'objet RecognizerContext est réinitialisé, toute reconnaissance effectuée sur le thread d'arrière-plan est annulée.

Pour que la propriété Strokes de l'objet RecognizerContext soit synchronisée avec les traits associés à un objet Ink, utilisez les événements InkAdded et InkDeleted de l'objet Ink pour écouter les traits qui doivent être ajoutés ou supprimés de la collection Strokes assignée à l'objet RecognizerContext. Cela s'applique également lorsque des traits sont ajoutés, supprimés, découpés ou fractionnés dans l'objet Ink.

Remarque :
Les déplacements, mises à l'échelle ou autres transformations sur les traits dans l'objet Ink ne génèrent pas d'événements InkAdded ou InkDeleted. Procédez aux mêmes transformations sur les traits dans l'objet RecognizerContext pour maintenir la synchronisation de la propriété Strokes de l'objet RecognizerContext.

Exemples

Cet exemple C# supprime la propriété Strokes d'un objet RecognizerContext, theRecognizerContext, pour réinitialiser l'objet RecognizerContext sans affecter ses autres propriétés.

theRecognizerContext.Strokes = null;

Cet exemple Microsoft® Visual Basic® .NET supprime la propriété Strokes d'un objet RecognizerContext, theRecognizerContext, pour réinitialiser l'objet RecognizerContext sans affecter ses autres propriétés.

theRecognizerContext.Strokes = Nothing

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.