Rectangle.Contains 方法

定義

判斷指定的點是否包含在由這個 Rectangle 所定義的矩形區域中。Determines if the specified point is contained within the rectangular region defined by this Rectangle.

多載

Contains(Point)

判斷指定的點是否包含在這個 Rectangle 結構內。Determines if the specified point is contained within this Rectangle structure.

Contains(Rectangle)

判斷由 rect 表示的矩形區域是否完全包含在這個 Rectangle 結構中。Determines if the rectangular region represented by rect is entirely contained within this Rectangle structure.

Contains(Int32, Int32)

判斷指定的點是否包含在這個 Rectangle 結構內。Determines if the specified point is contained within this Rectangle structure.

Contains(Point)

判斷指定的點是否包含在這個 Rectangle 結構內。Determines if the specified point is contained within this Rectangle structure.

public:
 bool Contains(System::Drawing::Point pt);
public bool Contains (System.Drawing.Point pt);
member this.Contains : System.Drawing.Point -> bool
Public Function Contains (pt As Point) As Boolean

參數

pt
Point

要測試的 PointThe Point to test.

傳回

Boolean

如果由 pt 表示的點包含在這個 Rectangle 結構中,則這個方法會傳回 true,否則傳回 falseThis method returns true if the point represented by pt is contained within this Rectangle structure; otherwise false.

備註

包含的矩形必須針對此方法正規化,才能傳回精確的結果。The containing rectangle must be normalized for this method to return accurate results.

適用於

Contains(Rectangle)

判斷由 rect 表示的矩形區域是否完全包含在這個 Rectangle 結構中。Determines if the rectangular region represented by rect is entirely contained within this Rectangle structure.

public:
 bool Contains(System::Drawing::Rectangle rect);
public bool Contains (System.Drawing.Rectangle rect);
member this.Contains : System.Drawing.Rectangle -> bool
Public Function Contains (rect As Rectangle) As Boolean

參數

rect
Rectangle

要測試的 RectangleThe Rectangle to test.

傳回

Boolean

如果由 rect 表示的矩形區域完全包含在這個 Rectangle 結構中,則這個方法會傳回 true,否則傳回 falseThis method returns true if the rectangular region represented by rect is entirely contained within this Rectangle structure; otherwise false.

範例

下列程式碼範例示範 Contains 方法和 SystemPens 類別。The following code example demonstrates the Contains method and the SystemPens class. 此範例是專為搭配 Windows Form 使用所設計。This example is designed for use with a Windows Form. 將此程式碼貼入表單中,其中包含名為的按鈕 Button1DrawFirstRectangle 從表單的函式或 Load 方法呼叫,以及將 Button1_Click 方法與按鈕的事件產生關聯 ClickPaste 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.

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

備註

包含的矩形必須針對此方法正規化,才能傳回精確的結果。The containing rectangle must be normalized for this method to return accurate results.

適用於

Contains(Int32, Int32)

判斷指定的點是否包含在這個 Rectangle 結構內。Determines if the specified point is contained within this Rectangle structure.

public:
 bool Contains(int x, int y);
public 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 座標。The x-coordinate of the point to test.

y
Int32

要測試的點的 Y 座標。The y-coordinate of the point to test.

傳回

Boolean

如果由 xy 定義的點包含在這個 Rectangle 結構中,則這個方法會傳回 true,否則傳回 falseThis method returns true if the point defined by x and y is contained within this Rectangle structure; otherwise false.

備註

包含的矩形必須針對此方法正規化,才能傳回精確的結果。The containing rectangle must be normalized for this method to return accurate results.

適用於