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

プロパティ値

コントロールのクライアント領域の大きさを表す SizeA 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. AutoSizeControlこの例ではメソッドがあります、textPaddingコントロールのすべての端に適用する余白を表すパラメーター。The 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. SetClientSizeCoreを設定するメソッドが呼び出される、ClientSizeプロパティ。The SetClientSizeCore method is called to set the ClientSize property. ClientSizeプロパティは、常にでは変更されませんそのsetメソッドをオーバーライドするため、 SetClientSizeCore 、コードが実行されることを確認する方法と、ClientSizeプロパティを設定します。The 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.WidthSize.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 フォーム コントロールのレンダリングします。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.

適用対象

こちらもご覧ください