Control.ClientSize Control.ClientSize Control.ClientSize Control.ClientSize Property

Définition

Obtient ou définit la hauteur et la largeur de la zone cliente du contrôle.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

Valeur de propriété

Size qui représente les dimensions de la zone cliente du contrôle.A Size that represents the dimensions of the client area of the control.

Exemples

L’exemple de code suivant redimensionne le contrôle spécifié afin que le contrôle puisse prendre en charge son texte mis en forme.The following code example resizes the specified control so the control will accommodate its formatted text. Le texte mis en forme Text est la propriété avec l’Assigned Font du contrôle appliquée au texte.The formatted text is the Text property with the control's assigned Font applied to the text. La AutoSizeControl méthode de cet exemple possède également un textPadding paramètre qui représente la marge intérieure à appliquer à tous les bords du contrôle.The AutoSizeControl method in this example also has a textPadding parameter that represents the padding to apply to all edges of the control. Pour que la marge intérieure s’affiche, alignez le texte avec la ContentAlignment.MiddleCenter valeur, si votre contrôle le prend en charge.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

Remarques

La zone cliente d’un contrôle est les limites du contrôle, moins les éléments non clients tels que les barres de défilement, les bordures, les barres de titre et les menus.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. La SetClientSizeCore méthode est appelée pour définir la ClientSize propriété.The SetClientSizeCore method is called to set the ClientSize property. La ClientSize propriété n’est pas toujours modifiée via set sa méthode. vous devez donc substituer la SetClientSizeCore méthode pour vous assurer que votre code est ClientSize exécuté lorsque la propriété est définie.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.

Les Size.Width propriétés Size.Height et représentent la largeur et la hauteur de la zone cliente du contrôle.The Size.Width and Size.Height properties represent the width and height of the client area of the control. Vous pouvez utiliser cette propriété pour obtenir la taille de la zone cliente du contrôle pour des tâches telles que le dessin sur la surface du contrôle.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.

Pour plus d’informations sur le dessin sur des contrôles, consultez rendu d’un contrôle de Windows Forms.For more information about drawing on controls, see Rendering a Windows Forms Control.

Notes

Vous ne pouvez pas lier les paramètres d’application à cette propriété.You cannot bind application settings to this property. Pour plus d’informations sur les paramètres d’application, consultez vue d’ensemble des paramètres d’application.For more information on application settings, see Application Settings Overview.

S’applique à

Voir aussi