Stroke.GetBoundingBox-Methode

Artikel
11/26/2008

Gibt das umgebende Rechteck zurück, das das umgebende Rechteck für das Stroke-Objekt definiert.

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

Syntax

'Declaration
Public Function GetBoundingBox As Rectangle
'Usage
Dim instance As Stroke
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

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 ein Stroke-Objekt 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 ordnungsgemäße umgebende Rechteck 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 Rechtecks des Stroke-Objekts ist. Änderungen des von dieser Methode zurückgegebenen umgebenden Rechtecks wirken sich nicht auf das umgebende Rechteck des ursprünglichen Stroke-Objekts aus.

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.