Ink.Strokes, propriété

Article
11/05/2008

Mise à jour : November 2007

Obtient une copie de la collection Strokes contenue dans l'objet Ink.

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

Syntaxe

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

value = instance.Strokes

public Strokes Strokes { get; }

public:
property Strokes^ Strokes {
    Strokes^ get ();
}

/** @property */
public Strokes get_Strokes()

public function get Strokes () : Strokes

Valeur de propriété

Type : Microsoft.Ink.Strokes
Copie de la collection Strokes contenue dans l'objet Ink.

Notes

Remarque :
La propriété Strokes de l'objet Ink ne retourne pas la collection réelle avec laquelle l'objet Ink fonctionne, mais une copie. Par exemple, cela signifie qu'ajouter ou supprimer des traits dans cette collection n'affecte pas les traits de l'objet Ink ; pour ajouter ou supprimer des traits, utilisez des méthodes Ink, telles que AddStrokesAtRectangle, DeleteStroke et DeleteStrokes. Toutefois, chaque trait de la collection est une référence à l'objet Stroke d'origine.

La propriété Strokes de l'objet Ink ne retourne pas la collection réelle avec laquelle l'objet Ink fonctionne, mais une copie. Par exemple, cela signifie qu'ajouter ou supprimer des traits dans cette collection n'affecte pas les traits de l'objet Ink ; pour ajouter ou supprimer des traits, utilisez des méthodes Ink, telles que AddStrokesAtRectangle, DeleteStroke et DeleteStrokes. Toutefois, chaque trait de la collection est une référence à l'objet Stroke d'origine.

Les instances des collections de traits obtenues à partir d'un objet Ink à l'aide de cette méthode ne sont pas récupérées par le garbage collector. Pour éviter une fuite de mémoire, à chaque fois que vous travaillez avec l'une de ces collections, utilisez l'instruction using comme indiqué ci-dessous.

using (Strokes strokes = myInk.Strokes)
{
    int i = strokes.Count;
}

Exemples

Cet exemple C# obtient le nombre de traits collectés par un objet InkCollector, theInkCollector.

using (Strokes strokes = theInkCollector.Ink.Strokes)
{
    int numberOfStrokes = strokes.Count;
}

Cet exemple Microsoft Visual Basic.NET obtient le nombre de traits collectés par un objet InkCollector, theInkCollector.

Dim numberOfStrokes As Integer 
Using strokes As Microsoft.Ink.Strokes = theInkCollector.Ink.Strokes
    numberOfStrokes = strokes.Count()
End Using

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.