Strokes.Remove-Methode (Stroke)

Artikel
10/28/2008

Entfernt ein Stroke-Objekt aus der Strokes-Auflistung.

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

Syntax

'Declaration
Public Sub Remove ( _
    stroke As Stroke _
)
'Usage
Dim instance As Strokes
Dim stroke As Stroke

instance.Remove(stroke)

public void Remove(
    Stroke stroke
)

public:
void Remove(
    Stroke^ stroke
)

public void Remove(
    Stroke stroke
)

public function Remove(
    stroke : Stroke
)

Parameter

stroke
Typ: Microsoft.Ink.Stroke
Das zu entfernende Stroke-Objekt.

Hinweise

Stroke-Objekte sind Verweise auf Freihanddaten. Die Remove-Methode entfernt Freihanddatenverweise anstatt tatsächlicher Freihanddaten. Rufen Sie die Ink.DeleteStroke-Methode auf, um das Stroke-Objekt aus den tatsächlichen Freihanddaten zu löschen.

Die Stroke-Objekte in der Auflistung werden neu angeordnet, nachdem Sie die Remove-Methode aufgerufen haben. In Microsoft Visual Basic .NET wird beispielsweise nach dem Aufruf von Strokes.Remove(Strokes.Item(0)) alles, was Strokes.Item(1) war, zu Strokes.Item(0); analog wird alles, was strokes.Item(2) war, zu strokes.Item(1) usw.

Beispiele

In diesem C#-Beispiel werden Stroke-Objektverweise aus der Strokes-Auflistung (theLeftToRightStokes) entfernt, wenn der erste Punkt im Stroke sich nicht links vom letzten Punkt in Stroke befindet. Die ursprünglichen Daten im Ink-Objekt bleiben unverändert.

//...
foreach (Stroke testStroke in theLeftToRightStrokes)
{
    Point ptStart = testStroke.GetPoint(0);
    Point ptEnd = testStroke.GetPoint(testStroke.PacketCount - 1);
    if (ptStart.X > ptEnd.X)
        theLeftToRightStrokes.Remove(testStroke);
}

In diesem Visual Basic .NET-Beispiel werden Stroke-Objektverweise aus der Strokes-Auflistung (theLeftToRightStokes) entfernt, wenn der erste Punkt im Stroke sich nicht links vom letzten Punkt in Stroke befindet. Die ursprünglichen Daten im Ink-Objekt bleiben unverändert.

'...
Dim testStroke As Stroke
For Each testStroke in theLeftToRightStrokes
    Dim ptStart As Point = testStroke.GetPoint(0)
    Dim ptEnd As Point = testStroke.GetPoint(testStroke.PacketCount - 1)
    If ptStart.X > ptEnd.X Then
        TheLeftToRightStrokes.Remove(testStroke)
    End If
Next

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.