Ink.ExtractStrokes-Methode (Rectangle, ExtractFlags)

Artikel
11/26/2008

Extrahiert alle Stroke-Objekte, die innerhalb eines gegebenen Rechtecks liegen, wie angegeben durch Ausschneiden oder Kopieren aus dem Ink-Objekt und gibt ein neues Ink-Objekt zurück, das die extrahierte Strokes-Auflistung enthält.

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

Syntax

'Declaration
Public Function ExtractStrokes ( _
    extractionRectangle As Rectangle, _
    extractionFlags As ExtractFlags _
) As Ink
'Usage
Dim instance As Ink
Dim extractionRectangle As Rectangle
Dim extractionFlags As ExtractFlags
Dim returnValue As Ink

returnValue = instance.ExtractStrokes(extractionRectangle, _
    extractionFlags)

public Ink ExtractStrokes(
    Rectangle extractionRectangle,
    ExtractFlags extractionFlags
)

public:
Ink^ ExtractStrokes(
    Rectangle extractionRectangle, 
    ExtractFlags extractionFlags
)

public Ink ExtractStrokes(
    Rectangle extractionRectangle,
    ExtractFlags extractionFlags
)

public function ExtractStrokes(
    extractionRectangle : Rectangle, 
    extractionFlags : ExtractFlags
) : Ink

Parameter

extractionRectangle
Typ: System.Drawing.Rectangle
Das Rechteck, durch das die aus dem Ink-Objekt zu extrahierenden Freihandengaben beschränkt werden.

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 Stroke-Objekte enthält, die durch das angegebene Rechteck (2000 x 2000 HIMETRIC Einheiten) begrenzt werden. Die Strokes-Auflistung wird im ursprünglichen Ink-Objekt beibehalten, weil der extractionFlags-Parameter auf den CopyFromOriginal-Wert aus der ExtractFlags-Enumeration festgelegt wird.

Dim R As Rectangle = New Rectangle(0, 0, 2000, 2000)
Dim newInk As Ink = mInkOverlay.Ink.ExtractStrokes(R, ExtractFlags.CopyFromOriginal)

Rectangle R = new Rectangle(0, 0, 2000, 2000);
Ink newInk = mInkOverlay.Ink.ExtractStrokes(R, 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.