Freigeben über


Ink.ExtractStrokes-Methode (Strokes)

Extrahiert das angegebene Stroke-Objekt aus dem Ink-Objekt und gibt ein neues Ink-Objekt zurück, das die extrahierten Stroke-Objekte enthält.

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

Syntax

'Declaration
Public Function ExtractStrokes ( _
    strokes As Strokes _
) As Ink
'Usage
Dim instance As Ink
Dim strokes As Strokes
Dim returnValue As Ink

returnValue = instance.ExtractStrokes(strokes)
public Ink ExtractStrokes(
    Strokes strokes
)
public:
Ink^ ExtractStrokes(
    Strokes^ strokes
)
public Ink ExtractStrokes(
    Strokes strokes
)
public function ExtractStrokes(
    strokes : Strokes
) : Ink

Parameter

Rückgabewert

Typ: Microsoft.Ink.Ink
Gibt ein Ink-Objekt zurück, das die extrahierte Strokes-Auflistung enthält.

Hinweise

Im neuen Ink-Objekt werden die Zeichnungsattribute, -eigenschaften und -koordinaten des ursprünglichen Ink-Objekts beibehalten.

Das Standardverhalten für diese Methode besteht im Entfernen der Strokes-Auflistung aus dem ursprünglichen Ink-Objekt. Um die Strokes-Auflistung im ursprünglichen Ink-Objekt beizubehalten und eine Kopie der Ink zu erstellen, rufen Sie die ExtractStrokes-Überladung oder die ExtractStrokes-Überladung dieser Methode auf, wobei der extractionFlags-Parameter auf den CopyFromOriginal-Wert aus der ExtractFlags-Enumeration festgelegt ist.

Beispiele

In diesem Beispiel wird ein neues Ink-Objekt erstellt, das die ersten beiden Stroke-Objekte eines InkOverlay-Objekts enthält. Die extrahierten Stroke-Objekte werden aus dem ursprünglichen Ink-Objekt entfernt, das dem InkOverlay-Objekt zugeordnet ist.

' Access to the Strokes property returns a copy of the Strokes object.
' This copy must be implicitly (via using statement) or explicitly
' disposed of in order to asub a memory leak.
Using allStrokes As Strokes = mInkOverlay.Ink.Strokes
    If (allStrokes.Count > 2) Then
        Dim temp As Strokes = allStrokes.Ink.CreateStrokes()
        temp.Add(allStrokes(0))
        temp.Add(allStrokes(1))
        Dim newInk As Ink = allStrokes.Ink.ExtractStrokes(temp)
    End If
End Using
// Access to the Strokes property returns a copy of the Strokes object.
// This copy must be implicitly (via using statement) or explicitly
// disposed of in order to avoid a memory leak.
using (Strokes allStrokes = mInkOverlay.Ink.Strokes)
{
    if (allStrokes.Count > 2)
    {
        Strokes temp = allStrokes.Ink.CreateStrokes();
        temp.Add(allStrokes[0]);
        temp.Add(allStrokes[1]);
        Ink newInk = allStrokes.Ink.ExtractStrokes(temp);
    }
}

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.

Versionsinformationen

.NET Framework

Unterstützt in: 3.0

Siehe auch

Referenz

Ink-Klasse

Ink-Member

ExtractStrokes-Überladung

Microsoft.Ink-Namespace

Strokes

ExtractFlags