Control.ClientSize Propiedad

Definición

Obtiene o establece el alto y el ancho del área cliente del control.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

Valor de propiedad

Size que representa las dimensiones del área cliente del control.A Size that represents the dimensions of the client area of the control.

Atributos

Ejemplos

En el siguiente ejemplo de código se cambia el tamaño del control especificado para que el control quepa su texto con formato.The following code example resizes the specified control so the control will accommodate its formatted text. El texto con formato es la propiedad Text con el Font asignado del control que se aplica al texto.The formatted text is the Text property with the control's assigned Font applied to the text. En este ejemplo, el método AutoSizeControl también tiene un parámetro textPadding que representa el relleno que se va a aplicar a todos los bordes del control.The AutoSizeControl method in this example also has a textPadding parameter that represents the padding to apply to all edges of the control. Para que el relleno parezca igual, alinee el texto con el valor ContentAlignment.MiddleCenter, si el control lo admite.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

Comentarios

El área cliente de un control son los límites del control, menos los elementos no cliente como barras de desplazamiento, bordes, barras de título y menús.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. Se llama al método SetClientSizeCore para establecer la propiedad ClientSize.The SetClientSizeCore method is called to set the ClientSize property. La propiedad ClientSize no se cambia siempre a través de su método set, por lo que debe reemplazar el método SetClientSizeCore para asegurarse de que el código se ejecuta cuando se establece la propiedad ClientSize.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.

Las propiedades Size.Width y Size.Height representan el ancho y el alto del área cliente del control.The Size.Width and Size.Height properties represent the width and height of the client area of the control. Puede utilizar esta propiedad para obtener el tamaño del área cliente del control para tareas como dibujar en la superficie del control.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.

Para obtener más información sobre cómo dibujar en controles, vea representar un control de Windows Forms.For more information about drawing on controls, see Rendering a Windows Forms Control.

Nota

No se puede enlazar la configuración de la aplicación a esta propiedad.You cannot bind application settings to this property. Para obtener más información sobre la configuración de la aplicación, consulte Introducción a la configuraciónde la aplicación.For more information on application settings, see Application Settings Overview.

Se aplica a

Consulte también: