Strokes.GetBoundingBox-Methode

Artikel
11/26/2008

Gibt das umgebende Rechteck zurück, das das Stroke-Objekt enthält, indem mithilfe des standardmäßigen BoundingBoxMode-Flags die Begrenzungen bestimmt werden.

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

Syntax

'Declaration
Public Function GetBoundingBox As Rectangle
'Usage
Dim instance As Strokes
Dim returnValue As Rectangle

returnValue = instance.GetBoundingBox()

public Rectangle GetBoundingBox()

public:
Rectangle GetBoundingBox()

public Rectangle GetBoundingBox()

public function GetBoundingBox() : Rectangle

Rückgabewert

Typ: System.Drawing.Rectangle
Gibt das umgebende Rechteck zurück, welches das umgebende Feld für die Strokes-Auflistung definiert.

Hinweise

Das umgebende Rechteck wird in Freihandbereich-Koordinaten angegeben.

Das umgebende Rechteck entspricht dem Teil der Anzeige, der für ungültig erklärt oder neu gezeichnet werden kann, wenn eine Strokes-Auflistung angezeigt wird.

Wenn sich die Stiftbreite auf das umgebende Rechteck auswirkt, wird diese Breite entsprechend für die Ansichtstransformation des Renderer-Objekts skaliert. Zu diesem Zweck wird die Stiftbreite mit der Quadratwurzel der Determinanten der Ansichtstransformation multipliziert.

Hinweis

Wenn die Stiftbreite nicht explizit festgelegt wurde, beträgt sie standardmäßig 53. Sie müssen die Stiftbreite mit der Quadratwurzel der Determinanten multiplizieren, um das richtige umgebende Feld zu erhalten. Die Höhe und Breite des umgebenden Rechtecks werden in jede Richtung um die Hälfte dieses Betrags erweitert. Angenommen, die Stiftbreite beträgt 53, die Quadratwurzel der Determinante ist 50, und das umgebende Rechteck ist (0, 0, 1000, 1000). Die Anpassung der Stiftbreite an das umgebende Rechteck in jede Richtung wird als (53 * 50) / 2 berechnet, und die rechte und untere Seite werden um eins erhöht. Dies führt zu dem gerenderten umgebenden Rechteck (-1325, -1325, 2326, 2326).

Hinweis

Diese Methode gibt ein umgebendes Rechteck zurück, das eine Kopie des umgebenden Felds der Strokes-Auflistung ist. Änderungen des von dieser Methode zurückgegebenen umgebenden Rechtecks wirken sich nicht auf das umgebende Feld der ursprünglichen Strokes-Auflistung aus.

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.