Stroke.Clip-Methode

Artikel
11/26/2008

Entfernt die Teile des Stroke-Objekts, die außerhalb eines gegebenen Rechtecks liegen.

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

Syntax

'Declaration
Public Sub Clip ( _
    r As Rectangle _
)
'Usage
Dim instance As Stroke
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
Das Rechteck, dessen Umrisslinien definieren, welche Teile jedes Stroke-Objekts abgeschnitten werden.

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 jedes Stroke-Objekts 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 jedes ausgewählte Stroke-Objekt eines InkOverlay modifiziert. Zuerst wird die GetBoundingBox-Methode aufgerufen, um das umgebende Rechteck für einen ausgewählten Stroke zu bestimmen. Das resultierende Rechteck wird dann auf die Hälfte seiner ursprünglichen Breite geändert. Anschließend wird die Clip-Methode aufgerufen, um die rechte Hälfte des Stroke abzuschneiden.

For Each S As Stroke In mInkOverlay.Selection
    Dim sBounds As Rectangle = S.GetBoundingBox()
    ' decrease width by half
    sBounds.Width -= sBounds.Width / 2
    ' clip the stroke
    S.Clip(sBounds)
Next

foreach (Stroke S in mInkOverlay.Selection)
{
    Rectangle sBounds = S.GetBoundingBox();
    // decrease width by half
    sBounds.Width -= sBounds.Width / 2;
    // clip the stroke
    S.Clip(sBounds);
}

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.