Control.ClientRectangle Control.ClientRectangle Control.ClientRectangle Control.ClientRectangle Property

Définition

Obtient le rectangle qui représente la zone cliente du contrôle.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

Valeur de propriété

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

Exemples

L’exemple de code suivant active le défilement automatique pour un formulaire, redimensionne le formulaire et permet de s’assurer qu’un bouton reste visible une fois que le formulaire est redimensionné.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. Cet exemple nécessite que vous avez un Form avec un Button nommé button2 dessus.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

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.

Étant donné que les coordonnées clientes sont par rapport à l’angle supérieur gauche de la zone cliente du contrôle, les coordonnées du coin supérieur gauche du rectangle retourné par cette propriété sont (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). Vous pouvez utiliser cette propriété pour obtenir la taille et les coordonnées 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 and coordinates 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 de contrôles, consultez rendu d’un contrôle de formulaires Windows.For more information about drawing on controls, see Rendering a Windows Forms Control.

S’applique à

Voir aussi