Ink.ExtractStrokes-Methode (Rectangle)

Artikel
11/26/2008

Extrahiert alle Stroke-Objekte, die innerhalb eines gegebenen Rechtecks liegen, 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 _
) As Ink
'Usage
Dim instance As Ink
Dim extractionRectangle As Rectangle
Dim returnValue As Ink

returnValue = instance.ExtractStrokes(extractionRectangle)

public Ink ExtractStrokes(
    Rectangle extractionRectangle
)

public:
Ink^ ExtractStrokes(
    Rectangle extractionRectangle
)

public Ink ExtractStrokes(
    Rectangle extractionRectangle
)

public function ExtractStrokes(
    extractionRectangle : Rectangle
) : Ink

Parameter

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

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 ExtractFlags 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 Stroke-Objekte, die innerhalb des angegebenen Rechteck liegen, werden aus dem ursprünglichen Ink-Objekt entfernt, das dem InkOverlay-Objekt zugeordnet ist.

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

Rectangle R = new Rectangle(0, 0, 2000, 2000);
Ink newInk = mInkOverlay.Ink.ExtractStrokes(R);

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.