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

Определение

Возвращает или задает высоту и ширину клиентской области элемента управления.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

Значение свойства

Объект Size, представляющий измерения клиентской области элемента управления.A Size that represents the dimensions of the client area of the control.

Примеры

В следующем примере кода изменяет размер указанного элемента управления, чтобы он соответствовал его форматированного текста.The following code example resizes the specified control so the control will accommodate its formatted text. Форматированный текст — Text свойства с элементом управления назначенного Font применялись к тексту.The formatted text is the Text property with the control's assigned Font applied to the text. AutoSizeControl Метод в этом примере также имеет textPadding параметр, представляющий применяемое для всех краев элемента управления.The AutoSizeControl method in this example also has a textPadding parameter that represents the padding to apply to all edges of the control. Чтобы сделать заполнение казаться равными, выравнивать его относительно ContentAlignment.MiddleCenter значение, если элемент управления поддерживает его.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

Комментарии

Клиентской области элемента управления находится в границах элемента управления, за вычетом неклиентские элементы, такие как полосы прокрутки, границы, заголовки окон и меню.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. SetClientSizeCore Метод вызывается для установки ClientSize свойство.The SetClientSizeCore method is called to set the ClientSize property. ClientSize Свойство всегда не изменяется до его set метод, поэтому следует переопределить SetClientSizeCore метод, чтобы гарантировать выполнение кода при 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.

Size.Width И Size.Height свойства представляют ширина и Высота клиентской области элемента управления.The Size.Width and Size.Height properties represent the width and height of the client area of the 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.

Дополнительные сведения о рисовании на элементах управления см. в разделе отрисовка элементов управления Windows Forms.For more information about drawing on controls, see Rendering a Windows Forms Control.

Примечание

Не удается привязать параметры приложения для этого свойства.You cannot bind application settings to this property. Дополнительные сведения о параметрах приложения см. в разделе Общие сведения о параметрах приложения.For more information on application settings, see Application Settings Overview.

Применяется к

Дополнительно