Control.ClientRectangle Eigenschaft

  • Referenz

Definition

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Ruft das Rechteck ab, das den Clientbereich des Steuerelements darstellt.

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

Eigenschaftswert

Rectangle

Ein Rectangle, das den Clientbereich des Steuerelements darstellt.

Attribute
BrowsableAttribute

Beispiele

Im folgenden Codebeispiel wird das automatische Scrollen für ein Formular aktiviert, die Größe des Formulars geändert und sichergestellt, dass eine Schaltfläche nach der Größenänderung des Formulars sichtbar bleibt. In diesem Beispiel müssen Sie über einen Form Button benannten Namen button2 verfügen.

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 Clientbereich eines Steuerelements ist die Grenzen des Steuerelements, minus die nichtclientischen Elemente wie Bildlaufleisten, Rahmen, Titelleisten und Menüs.

Da Clientkoordinaten relativ zur oberen linken Ecke des Clientbereichs des Steuerelements sind, sind die Koordinaten der oberen linken Ecke des von dieser Eigenschaft zurückgegebenen Rechtecks (0,0). Sie können diese Eigenschaft verwenden, um die Größe und Koordinaten des Clientbereichs des Steuerelements für Vorgänge wie das Zeichnen auf der Oberfläche des Steuerelements abzurufen.

Weitere Informationen zum Zeichnen von Steuerelementen finden Sie unter Rendern eines Windows Forms Steuerelements.

Gilt für

Siehe auch