Stroke.GetBoundingBox-Methode (BoundingBoxMode)

Artikel
11/26/2008

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

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

Syntax

'Declaration
Public Function GetBoundingBox ( _
    mode As BoundingBoxMode _
) As Rectangle
'Usage
Dim instance As Stroke
Dim mode As BoundingBoxMode
Dim returnValue As Rectangle

returnValue = instance.GetBoundingBox(mode)

public Rectangle GetBoundingBox(
    BoundingBoxMode mode
)

public:
Rectangle GetBoundingBox(
    BoundingBoxMode mode
)

public Rectangle GetBoundingBox(
    BoundingBoxMode mode
)

public function GetBoundingBox(
    mode : BoundingBoxMode
) : Rectangle

Parameter

mode
Typ: Microsoft.Ink.BoundingBoxMode
Ein Member der BoundingBoxMode-Enumeration, das angibt, welche Merkmale eines Stroke-Objekts, z. B. Zeichnungsattribute, zum Berechnen des umgebenden Felds des Stroke-Objekts verwendet werden.

Rückgabewert

Typ: System.Drawing.Rectangle
Gibt das umgebende Rechteck zurück, das das umgebende Rechteck für das Stroke-Objekt 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 ein Stroke-Objekt angezeigt wird.

Das umgebende Rechteck wird für alle Modi mit Ausnahme des BoundingBoxMode-Modus zwischengespeichert.

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

In Windows Vista und höheren Versionen wird bei GetBoundingBox die Strichbreite nicht berücksichtigt.

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 C#-Beispiel wird das umgebende Rechteck eines Stroke-Objekts namens theStroke abgerufen. In diesem Beispiel werden mithilfe des CurveFit-Werts der BoundingBoxMode-Enumeration die Umrisslinien des umgebenden Rechtecks bestimmt.

Rectangle theBoundingBox = theStroke.GetBoundingBox(BoundingBoxMode.CurveFit);

In diesem Microsoft Visual Basic .NET-Beispiel wird das umgebende Rechteck des Stroke-Objekts namens theStroke abgerufen. In diesem Beispiel werden mithilfe des BoundingBoxMode-Werts der BoundingBoxMode-Enumeration die Umrisslinien des umgebenden Rechtecks bestimmt.

Dim theBoundingBox As Rectangle = theStroke.GetBoundingBox(BoundingBoxMode.CurveFit)

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.