Esta documentación está archivada y no tiene mantenimiento.

Control.ClientSize (Propiedad)

Obtiene o establece el alto y el ancho del área cliente del control.

Espacio de nombres: System.Windows.Forms
Ensamblado: System.Windows.Forms (en system.windows.forms.dll)

public Size ClientSize { get; set; }
/** @property */
public Size get_ClientSize ()

/** @property */
public void set_ClientSize (Size value)

public function get ClientSize () : Size

public function set ClientSize (value : Size)

No aplicable.

Valor de propiedad

Size que representa las dimensiones del área cliente del control.

El área cliente de un control se compone de los límites del control menos los elementos que no son clientes, como barras de desplazamiento, bordes, barras de título y menús. Se llama al método SetClientSizeCore para establecer el valor de la propiedad ClientSize. La propiedad ClientSize no siempre se cambia mediante su método set, por lo que se debe reemplazar el método SetClientSizeCore para garantizar que el código se ejecuta cuando se establece el valor de la propiedad ClientSize.

Las propiedades Size.Width y Size.Height representan el ancho y el alto del área cliente del control. Esta propiedad puede utilizarse para obtener el tamaño del área cliente del control, a fin de realizar tareas como dibujar en la superficie del control.

Para obtener más información sobre la forma de dibujar en controles, vea Representar un control de formularios Windows Forms.

NotaNota:

No puede enlazar la configuración de la aplicación a esta propiedad. Para obtener más información sobre la configuración de la aplicación, vea Información general sobre la configuración de la aplicación.

En el siguiente ejemplo de código se cambia el tamaño del control especificado para que quepa el texto con formato. El texto con formato es la propiedad Text con la propiedad asignada del control Font que se aplica al texto. El método AutoSizeControl de este ejemplo también tiene un parámetro textPadding, que representa el relleno que se aplica a todos los bordes del control. Para que la apariencia del relleno sea uniforme, se alinea el texto con el valor ContentAlignment.MiddleCenter si el control lo permite.

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 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.get_Text(), control.
        get_Font()).ToSize();
    // Pad the text and resize the control.
    control.set_ClientSize(new Size(preferredSize.get_Width() 
        + textPadding * 2, preferredSize.get_Height() + textPadding * 2));
    // Clean up the Graphics object.
    g.Dispose();
} //AutoSizeControl

Windows 98, Windows 2000 Service Pack 4, Windows CE, Windows Millennium, Windows Mobile para Pocket PC, Windows Mobile para Smartphone, Windows Server 2003, Windows XP Media Center, Windows XP Professional x64, Windows XP SP2, Windows XP Starter

Microsoft .NET Framework 3.0 es compatible con Windows Vista, Microsoft Windows XP SP2 y Windows Server 2003 SP1.

.NET Framework

Compatible con: 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Compatible con: 2.0, 1.0
Mostrar: