Control.ClientRectangle プロパティ

定義

コントロールのクライアント領域を表す四角形を取得します。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

プロパティ値

コントロールのクライアント領域を表す RectangleA 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. この例では、button2 という名前の Button を持つ Form が必要です。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 フォームコントロールのレンダリング」を参照してください。For more information about drawing on controls, see Rendering a Windows Forms Control.

適用対象

こちらもご覧ください