Renderer.Measure Method (Strokes)
Calculates the Rectangle on the device context needed to contain the Strokes collection to be drawn with the Draw method of the Renderer object.
Namespace: Microsoft.Ink
Assembly: Microsoft.Ink (in Microsoft.Ink.dll)
Syntax
'Declaration
Public Function Measure ( _
strokes As Strokes _
) As Rectangle
'Usage
Dim instance As Renderer
Dim strokes As Strokes
Dim returnValue As Rectangle
returnValue = instance.Measure(strokes)
public Rectangle Measure(
Strokes strokes
)
public:
Rectangle Measure(
Strokes^ strokes
)
public function Measure(
strokes : Strokes
) : Rectangle
Parameters
strokes
Type: Microsoft.Ink.StrokesThe Strokes collection to measure.
Return Value
Type: System.Drawing.Rectangle
The Rectangle on the device context needed to contain the
strokes if the strokes were drawn with the Draw method of the Renderer object. The strokes must contain x-coordinates and y-coordinates to calculate the rectangle. Otherwise, the method returns an empty rectangle.
Remarks
This method is accurate only if you pass the same arguments to both the Measure and Draw methods.
Because the bounding box is affected by the pen width, 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. The height and width of the bounding box are expanded by half this amount in each direction, and the right and bottom sides are incremented by one.
For example, consider that the pen width is originally 53, the square root of the determinant of the view transform is 50, 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).
Examples
This C# example gets the bounding rectangle for the Strokes collection in the InkCollector object, theInkCollector.
Rectangle theMeasure = theInkCollector.Renderer.Measure(theInkCollector.Ink.Strokes);
This Microsoft® Visual Basic® .NET example gets the bounding rectangle for the Strokes collection in the InkCollector object, theInkCollector.
Dim theMeasure As Rectangle = theInkCollector.Renderer.Measure(theInkCollector.Ink.Strokes)
Platforms
Windows 7, Windows Vista, Windows Server 2008 R2, Windows Server 2008
The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Version Information
.NET Framework
Supported in: 3.0