Control.ClientSize Control.ClientSize Control.ClientSize Control.ClientSize Property

Definição

Obtém ou define a altura e a largura da área de cliente do controle.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 da propriedade

Um Size que representa as dimensões da área de cliente do controle.A Size that represents the dimensions of the client area of the control.

Exemplos

O exemplo de código a seguir redimensiona o controle especificado para que o controle acomode seu texto formatado.The following code example resizes the specified control so the control will accommodate its formatted text. O texto formatado é a Text Propriedade com a atribuição Font do controle aplicada ao texto.The formatted text is the Text property with the control's assigned Font applied to the text. O AutoSizeControl método neste exemplo também tem um textPadding parâmetro que representa o preenchimento a ser aplicado a todas as bordas do controle.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 o preenchimento pareça igual, alinhe o texto com o ContentAlignment.MiddleCenter valor, se o seu controle oferecer suporte a ele.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

Comentários

A área do cliente de um controle são os limites do controle, menos os elementos que não são do cliente, como barras de rolagem, bordas, barras de título e 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. O SetClientSizeCore método é chamado para definir a ClientSize propriedade.The SetClientSizeCore method is called to set the ClientSize property. A ClientSize Propriedade nem sempre é alterada por meio set de seu método, portanto, SetClientSizeCore você deve substituir o método para garantir que seu código ClientSize seja executado quando a propriedade for definida.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.

As Size.Width propriedades Size.Height e representam a largura e a altura da área do cliente do controle.The Size.Width and Size.Height properties represent the width and height of the client area of the control. Você pode usar essa propriedade para obter o tamanho da área de cliente do controle para tarefas como desenhar na superfície do controle.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 obter mais informações sobre como desenhar em controles, consulte renderizando um controle de Windows Forms.For more information about drawing on controls, see Rendering a Windows Forms Control.

Observação

Não é possível associar as configurações do aplicativo a esta propriedade.You cannot bind application settings to this property. Para obter mais informações sobre as configurações do aplicativo, consulte visão geral das configurações do aplicativo.For more information on application settings, see Application Settings Overview.

Aplica-se a

Veja também