Control.ClientRectangle Control.ClientRectangle Control.ClientRectangle Control.ClientRectangle Property

Определение

Возвращает прямоугольник, представляющий клиентскую область элемента управления.Gets the rectangle that represents the client area of the control.

public:
 property System::Drawing::Rectangle ClientRectangle { System::Drawing::Rectangle get(); };
[System.ComponentModel.Browsable(false)]
public System.Drawing.Rectangle ClientRectangle { get; }
member this.ClientRectangle : System.Drawing.Rectangle
Public ReadOnly Property ClientRectangle As Rectangle

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

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

Примеры

В следующем примере кода включается автоматическая прокрутка для формы, размера формы и гарантирует, что кнопка остается видимым после изменения размеров формы.The following code example enables auto-scrolling for a form, resizes the form, and ensures that a button remains visible after the form is resized. В этом примере требуется наличие Form с Button с именем button2 на нем.This example requires that you have a Form with a Button named button2 on it.

private:
   void ResizeForm()
   {
      
      // Enable auto-scrolling for the form.
      this->AutoScroll = true;
      
      // Resize the form.
      Rectangle r = this->ClientRectangle;
      
      // Subtract 100 pixels from each side of the Rectangle.
      r.Inflate(  -100, -100 );
      this->Bounds = this->RectangleToScreen( r );
      
      // Make sure button2 is visible.
      this->ScrollControlIntoView( button2 );
   }
private void ResizeForm()
{
   // Enable auto-scrolling for the form.
   this.AutoScroll = true;

   // Resize the form.
   Rectangle r = this.ClientRectangle;
   // Subtract 100 pixels from each side of the Rectangle.
   r.Inflate(-100, -100);
   this.Bounds = this.RectangleToScreen(r);

   // Make sure button2 is visible.
   this.ScrollControlIntoView(button2);
}
Private Sub ResizeForm()
   ' Enable auto-scrolling for the form.
   Me.AutoScroll = True
   
   ' Resize the form.
   Dim r As Rectangle = Me.ClientRectangle
   ' Subtract 100 pixels from each side of the Rectangle.
   r.Inflate(- 100, - 100)
   Me.Bounds = Me.RectangleToScreen(r)
   
   ' Make sure button2 is visible.
   Me.ScrollControlIntoView(button2)
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.

Поскольку клиентские координаты указываются относительно левого верхнего угла клиентской области элемента управления, координаты верхнего левого угла прямоугольника, возвращаемого этим свойством, (0,0).Because client coordinates are relative to the upper-left corner of the client area of the control, the coordinates of the upper-left corner of the rectangle returned by this property are (0,0). Это свойство можно использовать для получения размера и координаты клиентской области элемента управления для задач, таких как рисование на поверхности элемента управления.You can use this property to obtain the size and coordinates 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.

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

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