BrickGraphics.MeasureString(String, Int32) Method
Measures the specified string when drawn with the specified maximum width.
Namespace: DevExpress.XtraPrinting
Assembly: DevExpress.Printing.v24.2.Core.dll
NuGet Package: DevExpress.Printing.Core
#Declaration
#Parameters
Name | Type | Description |
---|---|---|
text | String | String to measure. |
width | Int32 | An integer value specifying the maximum width of the measured string. |
#Returns
Type | Description |
---|---|
Size |
This method returns a Size |
#Remarks
This method measures a text string specified via the parameter. The resulting string size is determined not only by the string’s contents, but also by the BrickGraphics.Font property value. If measured string width exceeds the width parameter value, then the height parameter value of the returned SizeF structure is increased, in order to fit inside the measured string.
#Example
This example calculates the dimensions of the rectangle to fit the specified string with a limitation on maximum width (75 measurement units). Then, a report with the VisualBrick, containing the string, is created and displayed.
using DevExpress.XtraPrinting;
// ...
VisualBrick visBrick;
BrickGraphics brickGraph = printingSystem1.Graph;
string s = "Developer Express Inc.";
// Measure the string, specifying the maximum width.
SizeF sz = brickGraph.MeasureString(s, 75);
// Start the report generation.
printingSystem1.Begin();
// Specify a page area.
brickGraph.Modifier = BrickModifier.Detail;
// Create a rectangle of the calculated size plus the border dimensions.
RectangleF rect = new RectangleF(new PointF(0, 0), sz);
rect = brickGraph.DefaultBrickStyle.InflateBorderWidth(rect, GraphicsDpi.Pixel);
rect.Offset(-rect.X, -rect.Y);
// Add a text brick to the report.
visBrick = brickGraph.DrawString(s, Color.Black, rect, BorderSide.All);
// Finish the report generation.
printingSystem1.End();
// Preview the report.
printingSystem1.PreviewFormEx.Show();