Stroke.GetBoundingBox Method
Stroke.GetBoundingBox Method |
Returns the bounding Rectangle that contains the Stroke object.
Definition
Visual Basic .NET Public Function GetBoundingBox() As Rectangle C# public Rectangle GetBoundingBox(); Managed C++ public: Rectangle* GetBoundingBox();
Return Value
System.Drawing.Rectangle. Returns the bounding Rectangle that defines the bounding box for the Stroke object.
Remarks
The bounding Rectangle is in ink space coordinates.
The bounding Rectangle corresponds to the portion of the display to invalidate or redraw when displaying a Stroke object.
When the bounding box is affected by the pen width, then this width is scaled appropriately for the Renderer object's view transform. To do this, the pen width is multiplied by the square root of the determinant of the view transform.
Note: If you have not set the pen width explicitly, it is 53 by default. You must multiply the pen width by the square root of the determinant to yield the correct bounding box. The height and width of the bounding box are expanded by half this amount in each direction. For example, consider that the pen width is
53
, the square root of the determinant is50
, and the bounding box is(0, 0, 1000, 1000)
. The pen width adjustment to the bounding box in each direction is calculated as(53 * 50) / 2
, and the right and bottom sides are incremented by one. This results in a rendered bounding box of(-1325, -1325, 2326, 2326)
.Note: The bounding Rectangle that this method returns is a copy of the bounding box of the Stroke object. Altering the Rectangle that this method returns has no affect on the bounding box of the original Stroke object.
Examples
[C#]
This C# example gets the bounding box from a Stroke object, theStroke.
Rectangle theBoundingBox = theStroke.GetBoundingBox();
[VB.NET]
This Microsoft® Visual Basic® .NET example gets the bounding box from a Stroke object, theStroke.
Dim theBoundingBox As Rectangle = theStroke.GetBoundingBox()
See Also