Control.ClientSize 속성

정의

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

속성 값

컨트롤 클라이언트 영역의 크기를 나타내는 Size입니다.A 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. 서식이 지정 된 텍스트는 컨트롤의 할당 된 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

설명

컨트롤의 클라이언트 영역은 컨트롤의 범위 이며, 스크롤 막대, 테두리, 제목 표시줄 및 메뉴와 같은 비클라이언트 요소를 제외 합니다.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.

참고

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

적용 대상

추가 정보