Ink.ExtractStrokes-Methode (Strokes, ExtractFlags)

Artikel
11/26/2008

Extrahiert das angegebene Stroke-Objekt wie angegeben durch Ausschneiden oder Kopieren 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, _
    extractionFlags As ExtractFlags _
) As Ink
'Usage
Dim instance As Ink
Dim strokes As Strokes
Dim extractionFlags As ExtractFlags
Dim returnValue As Ink

returnValue = instance.ExtractStrokes(strokes, _
    extractionFlags)

public Ink ExtractStrokes(
    Strokes strokes,
    ExtractFlags extractionFlags
)

public:
Ink^ ExtractStrokes(
    Strokes^ strokes, 
    ExtractFlags extractionFlags
)

public Ink ExtractStrokes(
    Strokes strokes,
    ExtractFlags extractionFlags
)

public function ExtractStrokes(
    strokes : Strokes, 
    extractionFlags : ExtractFlags
) : Ink

Parameter

strokes
Typ: Microsoft.Ink.Strokes
Die zu extrahierende Strokes-Auflistung.

extractionFlags
Typ: Microsoft.Ink.ExtractFlags
Einer der ExtractFlags-Werte, der angibt, ob die Freihandeingabe in das neue Ink-Objekt ausgeschnitten oder kopiert wird.

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 Strokes-Auflistung wird im ursprünglichen Ink-Objekt beibehalten, weil der extractionFlags-Parameter auf den CopyFromOriginal-Wert aus der ExtractFlags-Enumeration festgelegt wird.

' 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, ExtractFlags.CopyFromOriginal)
    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, ExtractFlags.CopyFromOriginal);
    }
}

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.