Control.ClientRectangle Właściwość

Definicja

Pobiera prostokąt, który reprezentuje obszar klienta kontrolki.Gets the rectangle that represents the client area of the control.

public:
 property System::Drawing::Rectangle ClientRectangle { System::Drawing::Rectangle get(); };
[System.ComponentModel.Browsable(false)]
public System.Drawing.Rectangle ClientRectangle { get; }
[<System.ComponentModel.Browsable(false)>]
member this.ClientRectangle : System.Drawing.Rectangle
Public ReadOnly Property ClientRectangle As Rectangle

Wartość właściwości

Rectangle

RectangleReprezentuje obszar klienta kontrolki.A Rectangle that represents the client area of the control.

Atrybuty

Przykłady

Poniższy przykład kodu umożliwia Autoprzewijanie formularza, zmienia rozmiar formularza i gwarantuje, że przycisk pozostaje widoczny po zmianie rozmiaru formularza.The following code example enables auto-scrolling for a form, resizes the form, and ensures that a button remains visible after the form is resized. Ten przykład wymaga, aby miał nazwę Form z Button nazwą button2 .This example requires that you have a Form with a Button named button2 on it.

private:
   void ResizeForm()
   {
      
      // Enable auto-scrolling for the form.
      this->AutoScroll = true;
      
      // Resize the form.
      Rectangle r = this->ClientRectangle;
      
      // Subtract 100 pixels from each side of the Rectangle.
      r.Inflate(  -100, -100 );
      this->Bounds = this->RectangleToScreen( r );
      
      // Make sure button2 is visible.
      this->ScrollControlIntoView( button2 );
   }
private void ResizeForm()
{
   // Enable auto-scrolling for the form.
   this.AutoScroll = true;

   // Resize the form.
   Rectangle r = this.ClientRectangle;
   // Subtract 100 pixels from each side of the Rectangle.
   r.Inflate(-100, -100);
   this.Bounds = this.RectangleToScreen(r);

   // Make sure button2 is visible.
   this.ScrollControlIntoView(button2);
}
Private Sub ResizeForm()
   ' Enable auto-scrolling for the form.
   Me.AutoScroll = True
   
   ' Resize the form.
   Dim r As Rectangle = Me.ClientRectangle
   ' Subtract 100 pixels from each side of the Rectangle.
   r.Inflate(- 100, - 100)
   Me.Bounds = Me.RectangleToScreen(r)
   
   ' Make sure button2 is visible.
   Me.ScrollControlIntoView(button2)
End Sub

Uwagi

Obszar klienta kontrolki jest granicami kontrolki minus elementy nieklienckie, takie jak paski przewijania, obramowania, paski tytułu i menu.The client area of a control is the bounds of the control, minus the nonclient elements such as scroll bars, borders, title bars, and menus.

Ze względu na to, że współrzędne klienta są względne w lewym górnym rogu obszaru klienckiego kontrolki, współrzędne lewego górnego rogu prostokąta zwróconego przez tę właściwość są (0, 0).Because client coordinates are relative to the upper-left corner of the client area of the control, the coordinates of the upper-left corner of the rectangle returned by this property are (0,0). Ta właściwość umożliwia uzyskanie rozmiaru i współrzędnych obszaru klienta kontrolki dla zadań, takich jak rysowanie na powierzchni formantu.You can use this property to obtain the size and coordinates of the client area of the control for tasks such as drawing on the surface of the control.

Aby uzyskać więcej informacji na temat rysowania na kontrolkach, zobacz renderowanie kontrolki Windows Forms.For more information about drawing on controls, see Rendering a Windows Forms Control.

Dotyczy

Zobacz też