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

속성 값

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

적용 대상

추가 정보