Ink.GetBoundingBox-Methode (BoundingBoxMode)

Artikel
11/26/2008

Gibt das umgebende Rechteck zurück, welches alle Stroke-Objekte im Ink-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 Ink
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 Strichs, z. B. Zeichnungsattribute, zum Berechnen des umgebenden Rechtecks der Freihandeingabe verwendet werden.

Rückgabewert

Typ: System.Drawing.Rectangle
Das umgebende Rechteck, welches das umgebende Feld für die Strokes-Auflistung im Ink-Objekt definiert.

Hinweise

Das umgebende Rechteck wird in Freihandbereich-Koordinaten angegeben.

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. Betrachten Sie ein Beispiel, in dem die Stiftbreite gleich 53 ist, die Quadratwurzel der Determinante gleich 50 ist und das umgebende Rechteck die Koordinaten (0, 0, 1000, 1000) hat. 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 der Strokes-Auflistung des Ink-Objekts ist. Änderungen des von dieser Methode zurückgegebenen umgebenden Rechtecks wirken sich nicht auf das umgebende Rechteck des ursprünglichen Ink-Objekts aus.

Hinweis

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

Beispiele

In diesem C#-Beispiel wird das umgebende Rechteck zurückgegeben, das die Strokes-Auflistung in einem Ink-Objekt enthält. Dem Ink-Objekt ist ein InkCollector-Objekt theInkCollector zugeordnet In diesem Beispiel werden mithilfe des CurveFit-Werts der BoundingBoxMode-Enumeration die Umrisslinien des umgebenden Rechtecks bestimmt.

Rectangle theBoundingBox =
    theInkCollector.Ink.GetBoundingBox(BoundingBoxMode.CurveFit);

In diesem Microsoft Visual Basic .NET-Beispiel wird das umgebende Rechteck zurückgegeben, das die Strokes-Auflistung in einem Ink-Objekt enthält. Dem Ink-Objekt ist ein InkCollector-Objekt theInkCollector zugeordnet In diesem Beispiel werden mithilfe des BoundingBoxMode-Werts der BoundingBoxMode-Enumeration die Begrenzungen bestimmt.

Dim theBoundingBox As Rectangle = _
    theInkCollector.Ink.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.