Control.ClientSize Eigenschaft

Definition

Ruft die Höhe und Breite des Clientbereichs des Steuerelements ab oder legt diese fest.Gets or sets the height and width of the client area of the control.

public:
 property System::Drawing::Size ClientSize { System::Drawing::Size get(); void set(System::Drawing::Size value); };
[System.ComponentModel.Browsable(false)]
public System.Drawing.Size ClientSize { get; set; }
member this.ClientSize : System.Drawing.Size with get, set
Public Property ClientSize As Size

Eigenschaftswert

Ein Size, das die Abmessungen des Clientbereichs des Steuerelements darstellt.A Size that represents the dimensions of the client area of the control.

Attribute

Beispiele

Im folgenden Codebeispiel wird die Größe des angegebenen Steuer Elements geändert, sodass das Steuerelement seinen formatierten Text aufnehmen kann.The following code example resizes the specified control so the control will accommodate its formatted text. Der formatierte Text ist die Text-Eigenschaft, der das Steuerelement zugewiesen wurde, Font auf den Text angewendet wird.The formatted text is the Text property with the control's assigned Font applied to the text. Die AutoSizeControl-Methode in diesem Beispiel verfügt auch über einen textPadding-Parameter, der die Auffüll Zeichen darstellt, die auf alle Ränder des Steuer Elements angewendet werden sollen.The AutoSizeControl method in this example also has a textPadding parameter that represents the padding to apply to all edges of the control. Damit die Auffüll Zeichen gleich sind, richten Sie den Text mit dem ContentAlignment.MiddleCenter-Wert ein, wenn das Steuerelement ihn unterstützt.To make the padding appear equal, align the text with the ContentAlignment.MiddleCenter value, if your control supports it.

private:
   void AutoSizeControl( Control^ control, int textPadding )
   {
      
      // Create a Graphics object for the Control.
      Graphics^ g = control->CreateGraphics();
      
      // Get the Size needed to accommodate the formatted Text.
      System::Drawing::Size preferredSize = g->MeasureString( control->Text, control->Font ).ToSize();
      
      // Pad the text and resize the control.
      control->ClientSize = System::Drawing::Size( preferredSize.Width + (textPadding * 2), preferredSize.Height + (textPadding * 2) );
      
      // Clean up the Graphics object.
      delete g;
   }
private void AutoSizeControl(Control control, int textPadding)
{
   // Create a Graphics object for the Control.
   Graphics g = control.CreateGraphics();

   // Get the Size needed to accommodate the formatted Text.
   Size preferredSize = g.MeasureString(
      control.Text, control.Font).ToSize();

   // Pad the text and resize the control.
   control.ClientSize = new Size(
      preferredSize.Width + (textPadding * 2), 
      preferredSize.Height+(textPadding * 2) );

   // Clean up the Graphics object.
   g.Dispose();
}
Private Sub AutoSizeControl(control As Control, textPadding As Integer)
   ' Create a Graphics object for the Control.
   Dim g As Graphics = control.CreateGraphics()
   
   ' Get the Size needed to accommodate the formatted Text.
   Dim preferredSize As Size = g.MeasureString( _
     control.Text, control.Font).ToSize()
   
   ' Pad the text and resize the control.
   control.ClientSize = New Size( _
     preferredSize.Width + textPadding * 2, _
     preferredSize.Height + textPadding * 2)
   
   ' Clean up the Graphics object.
   g.Dispose()
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. Die SetClientSizeCore-Methode wird aufgerufen, um die ClientSize-Eigenschaft festzulegen.The SetClientSizeCore method is called to set the ClientSize property. Die ClientSize-Eigenschaft wird nicht immer durch ihre set-Methode geändert, daher sollten Sie die SetClientSizeCore-Methode überschreiben, um sicherzustellen, dass der Code ausgeführt wird, wenn die ClientSize-Eigenschaft festgelegt ist.The ClientSize property is not always changed through its set method so you should override the SetClientSizeCore method to ensure that your code is executed when the ClientSize property is set.

Die Eigenschaften "Size.Width" und "Size.Height" stellen die Breite und Höhe des Client Bereichs des Steuer Elements dar.The Size.Width and Size.Height properties represent the width and height of the client area of the control. Mit dieser Eigenschaft können Sie die Größe des Client Bereichs des Steuer Elements für Aufgaben wie z. b. das Zeichnen auf der Oberfläche des Steuer Elements abrufen.You can use this property to obtain the size 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.

Hinweis

Die Anwendungseinstellungen können nicht an diese Eigenschaft gebunden werden.You cannot bind application settings to this property. Weitere Informationen zu Anwendungseinstellungen finden Sie unter Übersicht über Anwendungseinstellungen.For more information on application settings, see Application Settings Overview.

Gilt für:

Siehe auch