Control.ClientSize Property

Definition

컨트롤 클라이언트 영역의 높이와 너비를 가져오거나 설정합니다.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

Property Value

Size

컨트롤 클라이언트 영역의 크기를 나타내는 Size입니다.A Size that represents the dimensions of the client area of the control.

Attributes

Examples

컨트롤의 서식 있는 텍스트에 연결할 수 있도록 다음 코드 예제에서는 지정된 된 컨트롤을 크기 조정 합니다.The following code example resizes the specified control so the control will accommodate its formatted text. 서식이 지정 된 텍스트는 컨트롤의 할당 된 Font 텍스트에 적용 된 Text 속성입니다.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

Remarks

컨트롤의 클라이언트 영역은 제외한 스크롤 막대, 테두리, 제목 표시줄 및 메뉴 같은 비클라이언트 요소를 사용 하는 컨트롤의 범위입니다.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 메서드를 통해 변경 되지 않으므로 ClientSize 속성이 설정 될 때 코드가 실행 되도록 SetClientSizeCore 메서드를 재정의 해야 합니다.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 Forms 컨트롤 렌더링을 참조 하세요.For more information about drawing on controls, see Rendering a Windows Forms Control.

Note

응용 프로그램 설정을이 속성에 바인딩할 수 없습니다.You cannot bind application settings to this property. 애플리케이션 설정에 대 한 자세한 내용은 참조 하세요. 애플리케이션 설정 개요합니다.For more information on application settings, see Application Settings Overview.

Applies to

See also