Control.ClientRectangle プロパティ

コントロールのクライアント領域を表す四角形を取得します。

Public ReadOnly Property ClientRectangle As Rectangle
[C#]
public Rectangle ClientRectangle {get;}
[C++]
public: __property Rectangle get_ClientRectangle();
[JScript]
public function get ClientRectangle() : Rectangle;

プロパティ値

コントロールのクライアント領域を表す Rectangle 。

解説

コントロールのクライアント領域とは、コントロールの範囲から、スクロール バー、境界線、タイトル バー、メニューなどのクライアント以外の要素を除いた部分です。

クライアント座標は、コントロールのクライアント領域の左上隅に対する相対座標であるため、このプロパティによって返される四角形の左上隅の座標は (0,0) となります。このプロパティを使用して、コントロールの表面の描画などのタスクに対して、コントロールのクライアント領域のサイズと座標を取得できます。

コントロール上の描画については、「 Windows フォーム コントロールのレンダリング 」を参照してください。

使用例

[Visual Basic, C#, C++] フォームでの自動スクロール機能を有効にしてそのフォームのサイズを変更し、サイズ変更した後もボタンが非表示にならないようにする例を次に示します。この例は、 button2 という名前の Button が配置された Form があることを前提にしています。

 
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

[C#] 
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);
}

[C++] 
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);
    }

[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン をクリックします。

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ, .NET Compact Framework - Windows CE .NET

参照

Control クラス | Control メンバ | System.Windows.Forms 名前空間 | ClientSize | DrawMode