Rectangle.Contains 方法

定義

命名空間:

System.Drawing

組件:

System.Drawing.Primitives.dll

判斷指定的點是否包含在由這個 Rectangle 所定義的矩形區域中。

多載

Contains(Point)	判斷指定的點是否包含在這個 Rectangle 結構內。
Contains(Rectangle)	判斷由 rect 表示的矩形區域是否完全包含在這個 Rectangle 結構中。
Contains(Int32, Int32)	判斷指定的點是否包含在這個 Rectangle 結構內。

Contains(Point)

來源:

Rectangle.cs

判斷指定的點是否包含在這個 Rectangle 結構內。

public:
 bool Contains(System::Drawing::Point pt);

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

member this.Contains : System.Drawing.Point -> bool

Public Function Contains (pt As Point) As Boolean

參數

pt

Point

要測試的 Point。

傳回

Boolean

如果由 pt 表示的點包含在這個 Rectangle 結構中，則這個方法會傳回 true，否則傳回 false。

備註

必須正規化包含的矩形，這個方法才能傳回精確的結果。

Contains(Rectangle)

來源:

Rectangle.cs

判斷由 rect 表示的矩形區域是否完全包含在這個 Rectangle 結構中。

public:
 bool Contains(System::Drawing::Rectangle rect);

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

member this.Contains : System.Drawing.Rectangle -> bool

Public Function Contains (rect As Rectangle) As Boolean

參數

rect

Rectangle

要測試的 Rectangle。

傳回

Boolean

如果由 rect 表示的矩形區域完全包含在這個 Rectangle 結構中，則這個方法會傳回 true，否則傳回 false。

範例

下列程式代碼範例示範 Contains 方法和 SystemPens 類別。 此範例的設計目的是要與 Windows Form 搭配使用。 將此程式代碼貼到包含名為 Button1的按鈕的表單中，從表單的建構函式或Load方法呼叫DrawFirstRectangle，並將方法與按鈕Click的事件產生關聯Button1_Click。

private:
   [UIPermission(SecurityAction::Demand, Window=UIPermissionWindow::AllWindows)]
   void DrawFirstRectangle()
   {
      Rectangle rectangle1 = Rectangle(70,70,100,150);
      ControlPaint::DrawReversibleFrame( rectangle1, SystemColors::Highlight, FrameStyle::Thick );
   }

   void Button1_Click( Object^ /*sender*/, EventArgs^ /*e*/ )
   {
      Rectangle rectangle1 = Rectangle(70,70,100,150);

      // 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 ) )
      {
         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 );
      }
   }

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);
    }
}

Dim rectangle1 As New Rectangle(70, 70, 100, 150)

Private Sub DrawFirstRectangle()
    ControlPaint.DrawReversibleFrame(rectangle1, _
        SystemColors.Highlight, FrameStyle.Thick)
End Sub

Private Sub Button1_Click(ByVal sender As Object, _
    ByVal e As EventArgs) Handles Button1.Click

    ' Get the bounds of the screen.
    Dim screenRectangle As Rectangle = Screen.PrimaryScreen.Bounds

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

        ' 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)
    End If
End Sub

備註

必須正規化包含的矩形，這個方法才能傳回精確的結果。

Contains(Int32, Int32)

來源:

Rectangle.cs

判斷指定的點是否包含在這個 Rectangle 結構內。

public:
 bool Contains(int x, int y);

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

member this.Contains : int * int -> bool

Public Function Contains (x As Integer, y As Integer) As Boolean

參數

x

Int32

要測試的點的 X 座標。

y

Int32

要測試的點的 Y 座標。

傳回

Boolean

如果由 x 和 y 定義的點包含在這個 Rectangle 結構中，則這個方法會傳回 true，否則傳回 false。

備註

必須正規化包含的矩形，這個方法才能傳回精確的結果。