Control.ClientRectangle Eigenschaft

Definition

Ruft das Rechteck ab, das den Clientbereich des Steuerelements darstellt.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; }
member this.ClientRectangle : System.Drawing.Rectangle
Public ReadOnly Property ClientRectangle As Rectangle

Eigenschaftswert

Ein Rectangle, das den Clientbereich des Steuerelements darstellt.A Rectangle that represents the client area of the control.

Attribute

Beispiele

Im folgenden Codebeispiel wird der automatische Bildlauf für ein Formular aktiviert, die Größe des Formulars geändert und sichergestellt, dass eine Schaltfläche sichtbar bleibt, nachdem die Größe des Formulars geändert wurde.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. Für dieses Beispiel ist es erforderlich, dass Sie über eine Form mit einem Button mit dem Namen button2 verfügen.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

Hinweise

Der Client Bereich eines Steuer Elements ist die Begrenzungen des Steuer Elements, abzüglich der nicht-Client Elemente wie Scrollleisten, Rahmen, Titelleisten und Menüs.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.

Da Client Koordinaten relativ zur oberen linken Ecke des Client Bereichs des Steuer Elements sind, sind die Koordinaten der oberen linken Ecke des Rechtecks, das von dieser Eigenschaft zurückgegeben wird, (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). Sie können diese Eigenschaft verwenden, um die Größe und die Koordinaten des Client Bereichs des Steuer Elements für Aufgaben wie z. b. das Zeichnen auf der Oberfläche des Steuer Elements abzurufen.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.

Weitere Informationen zum Zeichnen von Steuerelementen finden Sie unter Rendering eines Windows Forms-SteuerElements.For more information about drawing on controls, see Rendering a Windows Forms Control.

Gilt für:

Siehe auch