Exportar (0) Imprimir
Expandir todo
Expandir Minimizar

Control.ClientSize (Propiedad)

Actualización: noviembre 2007

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)

[BrowsableAttribute(false)]
public Size ClientSize { get; set; }
/** @property */
/** @attribute BrowsableAttribute(false) */
public Size get_ClientSize()
/** @property */
/** @attribute BrowsableAttribute(false) */
public  void set_ClientSize(Size value)

public function get ClientSize () : Size
public function set ClientSize (value : Size)

Valor de propiedad

Tipo: System.Drawing.Size
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.

k413bhbc.alert_note(es-es,VS.90).gifNota:

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 Introducción a 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 Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile para Smartphone, Windows Mobile para Pocket PC

.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

.NET Framework

Compatible con: 3.5, 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Compatible con: 3.5, 2.0, 1.0

Adiciones de comunidad

AGREGAR
Mostrar:
© 2015 Microsoft