Rectangle.Contains Method

Definition

Determines if the specified point is contained within the rectangular region defined by this Rectangle.

Overloads

Contains(Point)

Determines if the specified point is contained within this Rectangle structure.

Contains(Rectangle)

Determines if the rectangular region represented by rect is entirely contained within this Rectangle structure.

Contains(Int32, Int32)

Determines if the specified point is contained within this Rectangle structure.

Contains(Point)

Source:
Rectangle.cs
Source:
Rectangle.cs
Source:
Rectangle.cs

Determines if the specified point is contained within this Rectangle structure.

C#
public readonly bool Contains(System.Drawing.Point pt);
C#
public bool Contains(System.Drawing.Point pt);

Parameters

pt
Point

The Point to test.

Returns

This method returns true if the point represented by pt is contained within this Rectangle structure; otherwise false.

Remarks

The containing rectangle must be normalized for this method to return accurate results.

Applies to

.NET 9 and other versions
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

Contains(Rectangle)

Source:
Rectangle.cs
Source:
Rectangle.cs
Source:
Rectangle.cs

Determines if the rectangular region represented by rect is entirely contained within this Rectangle structure.

C#
public readonly bool Contains(System.Drawing.Rectangle rect);
C#
public bool Contains(System.Drawing.Rectangle rect);

Parameters

rect
Rectangle

The Rectangle to test.

Returns

This method returns true if the rectangular region represented by rect is entirely contained within this Rectangle structure; otherwise false.

Examples

The following code example demonstrates the Contains method and the SystemPens class. This example is designed for use with a Windows Form. Paste this code into a form that contains a button named Button1, call DrawFirstRectangle from the form's constructor or Load method, and associate the Button1_Click method with the button's Click event.

C#
Rectangle rectangle1 = new Rectangle(70, 70, 100, 150);

private void DrawFirstRectangle()
{
    ControlPaint.DrawReversibleFrame(rectangle1, 
        SystemColors.Highlight, FrameStyle.Thick);
}

private void Button1_Click(object sender, EventArgs e)
{

    // Get the bounds of the screen.
    Rectangle screenRectangle = Screen.PrimaryScreen.Bounds;

    // Check to see if the rectangle is within the bounds of the screen.
    if (screenRectangle.Contains(rectangle1))

        // If so, erase the previous rectangle.
    {
        ControlPaint.DrawReversibleFrame(rectangle1, 
            SystemColors.Highlight, FrameStyle.Thick);

        // Call the Offset method to move the rectangle.
        rectangle1.Offset(20, 20);

        // Draw the new, offset rectangle.
        ControlPaint.DrawReversibleFrame(rectangle1, 
            SystemColors.Highlight, FrameStyle.Thick);
    }
}

Remarks

The containing rectangle must be normalized for this method to return accurate results.

Applies to

.NET 9 and other versions
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

Contains(Int32, Int32)

Source:
Rectangle.cs
Source:
Rectangle.cs
Source:
Rectangle.cs

Determines if the specified point is contained within this Rectangle structure.

C#
public readonly bool Contains(int x, int y);
C#
public bool Contains(int x, int y);

Parameters

x
Int32

The x-coordinate of the point to test.

y
Int32

The y-coordinate of the point to test.

Returns

This method returns true if the point defined by x and y is contained within this Rectangle structure; otherwise false.

Remarks

The containing rectangle must be normalized for this method to return accurate results.

Applies to

.NET 9 and other versions
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