Rectangle.Round(RectangleF) Method

Definition

Converts the specified RectangleF to a Rectangle by rounding the RectangleF values to the nearest integer values.

C#
public static System.Drawing.Rectangle Round(System.Drawing.RectangleF value);

Parameters

value
RectangleF

The RectangleF to be converted.

Returns

The rounded integer value of the Rectangle.

Examples

The following code example demonstrates how to use the Round and Truncate methods. This example is designed for use with a Windows Form. Paste this code into a form and call the RoundingAndTruncatingRectangles method when handling the form's Paint event, passing e as PaintEventArgs.

C#
private void RoundingAndTruncatingRectangles(PaintEventArgs e)
{

    // Construct a new RectangleF.
    RectangleF myRectangleF = 
        new RectangleF(30.6F, 30.7F, 40.8F, 100.9F);

    // Call the Round method.
    Rectangle roundedRectangle = Rectangle.Round(myRectangleF);

    // Draw the rounded rectangle in red.
    Pen redPen = new Pen(Color.Red, 4);
    e.Graphics.DrawRectangle(redPen, roundedRectangle);

    // Call the Truncate method.
    Rectangle truncatedRectangle = Rectangle.Truncate(myRectangleF);

    // Draw the truncated rectangle in white.
    Pen whitePen = new Pen(Color.White, 4);
    e.Graphics.DrawRectangle(whitePen, truncatedRectangle);

    // Dispose of the custom pens.
    redPen.Dispose();
    whitePen.Dispose();
}

Applies to

Product Versions
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1