Control.ClientSize Свойство

Определение

Пространство имен:

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

Возвращает или задает высоту и ширину клиентской области элемента управления.

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; }

[<System.ComponentModel.Browsable(false)>]
member this.ClientSize : System.Drawing.Size with get, set

Public Property ClientSize As Size

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

Size

Объект Size, представляющий измерения клиентской области элемента управления.

Атрибуты

BrowsableAttribute

Примеры

В следующем примере кода изменяется размер указанного элемента управления, чтобы элемент управления размещал форматированный текст. Отформатированный текст — это Text свойство с назначенным Font элементом управления к тексту. Метод AutoSizeControl в этом примере также имеет textPadding параметр, представляющий заполнение для применения ко всем краям элемента управления. Чтобы сделать заполнение равным, выровняйте текст со ContentAlignment.MiddleCenter значением, если элемент управления поддерживает его.

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

Комментарии

Клиентская область элемента управления — это границы элемента управления, за исключением неклиентных элементов, таких как полосы прокрутки, границы, заголовки и меню. Метод SetClientSizeCore вызывается для задания ClientSize свойства. Свойство ClientSize не всегда изменяется с помощью его set метода, поэтому следует переопределить SetClientSizeCore метод, чтобы убедиться, что код выполняется при ClientSize установке свойства.

Size.Height Свойства Size.Width представляют ширину и высоту клиентской области элемента управления. Это свойство можно использовать для получения размера клиентской области элемента управления для таких задач, как рисование на поверхности элемента управления.

Дополнительные сведения о рисовании элементов управления см. в разделе "Отрисовка элемента управления Windows Forms".

Примечание

Вы не можете привязать параметры приложения к этому свойству. Дополнительные сведения о параметрах приложения см. в разделе "Общие сведения о параметрах приложения".

См. также раздел

• ClientRectangle
• DrawMode