Ink.Strokes-Eigenschaft

Artikel
11/26/2008

Ruft eine Kopie der Strokes-Auflistung ab, die im Ink-Objekt enthalten ist.

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

Syntax

'Declaration
Public ReadOnly Property Strokes As Strokes
'Usage
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

Eigenschaftenwert

Typ: Microsoft.Ink.Strokes
Eine Kopie der Strokes-Auflistung, die im Ink-Objekt enthalten ist.

Hinweise

Hinweis

Die Strokes-Eigenschaft für das Ink-Objekt gibt nicht die Auflistung zurück, mit der das Ink-Objekt tatsächlich arbeitet, sondern eine Kopie. Das bedeutet beispielsweise, dass sich das Hinzufügen oder Entfernen von Strichen zu bzw. aus dieser Auflistung nicht auf die Striche des Ink-Objekts auswirkt. Verwenden Sie Ink-Methoden wie AddStrokesAtRectangle, DeleteStroke und DeleteStrokes, um Striche hinzuzufügen oder zu entfernen. Jeder Strich in der Auflistung ist jedoch ein Verweis auf das ursprüngliche Stroke-Objekt.

Instanzen von Strokes-Auflistungen, die mithilfe dieser Methode aus einem Ink-Objekt abgerufen werden, werden von der Garbage Collection nicht erfasst. Um einen Speicherverlust zu vermeiden, sollten Sie bei der Arbeit mit einer dieser Auflistungen die using-Anweisung in der unten gezeigten Weise verwenden:

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

Beispiele

In diesem C#-Beispiel wird die Anzahl der Striche abgerufen, die von einem InkCollector-Objekt namens theInkCollector erfasst wurden.

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

In diesem Microsoft® Visual Basic® .NET-Beispiel wird die Anzahl der Striche abgerufen, die von einem InkCollector-Objekt namens theInkCollector erfasst wurden.

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

Plattformen

Windows Vista

.NET Framework und .NET Compact Framework unterstützen nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.