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

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

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