Strokes.Clip-Methode

Artikel
10/28/2008

Entfernt die Teile jedes in der Strokes-Auflistung enthaltenen Stroke-Objekts, die sich außerhalb eines gegebenen Rechtecks befinden.

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

Syntax

'Declaration
Public Sub Clip ( _
    r As Rectangle _
)
'Usage
Dim instance As Strokes
Dim r As Rectangle

instance.Clip(r)

public void Clip(
    Rectangle r
)

public:
void Clip(
    Rectangle r
)

public void Clip(
    Rectangle r
)

public function Clip(
    r : Rectangle
)

Parameter

r
Typ: System.Drawing.Rectangle

Hinweise

Der R-Parameter wird in Freihandbereichkoordinaten angegeben.

Diese Methode aktualisiert das übergeordnete Ink-Objekt. Wenn Freihandeingaben aus einem Ink-Objekt entfernt werden, werden Stroke-Objekte oder Strokes-Auflistungen, die für dieses Ink-Objekt definiert sind, möglicherweise ungültig.

Nachdem Sie die Clip-Methode aufgerufen haben, ändern sich die Eigenschaften der Stroke-Objekte möglicherweise. Wenn beispielsweise ein Stroke-Objekt im Bereich des Cliprechtecks beginnt, das Cliprechteck verlässt und dann wieder in das Cliprechteck zurückkehrt, wird es zu zwei Stroke-Objekten, von denen mindestens eines über eine neue Id-Eigenschaft verfügt. Trotz dieses Verhaltens ist sichergestellt, dass alle Id-Eigenschaften in einem Ink-Objekt eindeutig sind, selbst wenn sie geändert werden. Andere Eigenschaften für das Stroke-Objekt werden möglicherweise auf vergleichbare Weise geändert.

Beispiele

In diesem Beispiel wird eine Strokes-Auflistung eines InkOverlay-Objekts auf der rechten Hälfte der Strokes-Auflistung abgeschnitten. Zunächst wird das umgebende Rechteck der Strokes-Auflistung durch Aufrufen der GetBoundingBox-Methode erstellt. Ein neues Rechteck mit abgeschnittener rechten Hälfte wird dann erstellt und an die Clip-Methode übergeben.

' 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 allStrokes As Strokes = mInkOverlay.Ink.Strokes
    ' Determine the bounding box for the Strokes collection.
    Dim bounds As Rectangle = allStrokes.GetBoundingBox()
    'Create rectangle for Clip method.
    Dim halfRectangle As Rectangle = _
            New Rectangle(bounds.Left, bounds.Top, bounds.Width / 2, bounds.Height)
    ' Clip the Strokes collection.
    allStrokes.Clip(halfRectangle)
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)
{
    // Determine the bounding box for the Strokes collection.
    Rectangle bounds = allStrokes.GetBoundingBox();
    //Create rectangle for Clip method.
    Rectangle halfRectangle = 
        new Rectangle(bounds.Left, bounds.Top, bounds.Width / 2, bounds.Height);
    // Clip the Strokes collection.
    allStrokes.Clip(halfRectangle);
}

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.