Control.ClientSize Eigenschaft

Definition

Ruft die Höhe und Breite des Clientbereichs des Steuerelements ab oder legt diese fest.

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; }
[<System.ComponentModel.Browsable(false)>]
member this.ClientSize : System.Drawing.Size with get, set
Public Property ClientSize As Size

Eigenschaftswert

Size

Ein Size, das die Abmessungen des Clientbereichs des Steuerelements darstellt.

Attribute

Beispiele

Im folgenden Codebeispiel wird die Größe des angegebenen Steuerelements geändert, sodass das Steuerelement seinen formatierten Text einnimmt. Der formatierte Text ist die Text Eigenschaft, der dem Text zugewiesen Font ist. Die AutoSizeControl Methode in diesem Beispiel verfügt auch über einen textPadding Parameter, der den Abstand darstellt, der auf alle Kanten des Steuerelements angewendet werden soll. Wenn der Abstand gleich angezeigt wird, richten Sie den Text mit dem ContentAlignment.MiddleCenter Wert aus, wenn das Steuerelement ihn unterstützt.

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 Clientbereich eines Steuerelements ist die Grenzen des Steuerelements, minus die nichtclientischen Elemente wie Bildlaufleisten, Rahmen, Titelleisten und Menüs. Die SetClientSizeCore Methode wird aufgerufen, um die ClientSize Eigenschaft festzulegen. Die ClientSize Eigenschaft wird nicht immer über die set Methode geändert, sodass Sie die SetClientSizeCore Methode außer Kraft setzen sollten, um sicherzustellen, dass der Code ausgeführt wird, wenn die ClientSize Eigenschaft festgelegt wird.

Die Size.Width Eigenschaften Size.Height stellen die Breite und Höhe des Clientbereichs des Steuerelements dar. Sie können diese Eigenschaft verwenden, um die Größe 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.

Hinweis

Sie können keine Anwendungseinstellungen an diese Eigenschaft binden. Weitere Informationen zu Anwendungseinstellungen finden Sie unter "Übersicht über Anwendungseinstellungen".

Gilt für

Siehe auch