Control.ClientRectangle Propiedad

Referencia

Definición

Espacio de nombres:: System.Windows.Forms

Ensamblado:: System.Windows.Forms.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Obtiene el rectángulo que representa el área cliente del control.

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

Valor de propiedad

Rectangle

Rectangle que representa el área cliente del control.

Atributos: BrowsableAttribute

Ejemplos

En el ejemplo de código siguiente se habilita el desplazamiento automático de un formulario, se cambia el tamaño del formulario y se garantiza que un botón permanece visible después de cambiar el tamaño del formulario. Este ejemplo requiere que tenga un Form con un Button nombre button2 en él.

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

Comentarios

El área cliente de un control es los límites del control, menos los elementos no cliente, como barras de desplazamiento, bordes, barras de título y menús.

Dado que las coordenadas de cliente son relativas a la esquina superior izquierda del área de cliente del control, las coordenadas de la esquina superior izquierda del rectángulo devuelto por esta propiedad son (0,0). Puede usar esta propiedad para obtener el tamaño y las coordenadas del área cliente del control para tareas como dibujar en la superficie del control.

Para obtener más información sobre cómo dibujar en controles, vea Representación de un control Windows Forms.

Se aplica a

Producto	Versiones
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8
Windows Desktop	3.0, 3.1, 5, 6, 7

Compartir a través de