DataGridView.AutoSizeRowsMode Property


행 높이의 결정 방법을 나타내는 값을 가져오거나 설정합니다.Gets or sets a value indicating how row heights are determined.

 property System::Windows::Forms::DataGridViewAutoSizeRowsMode AutoSizeRowsMode { System::Windows::Forms::DataGridViewAutoSizeRowsMode get(); void set(System::Windows::Forms::DataGridViewAutoSizeRowsMode value); };
public System.Windows.Forms.DataGridViewAutoSizeRowsMode AutoSizeRowsMode { get; set; }
member this.AutoSizeRowsMode : System.Windows.Forms.DataGridViewAutoSizeRowsMode with get, set
Public Property AutoSizeRowsMode As DataGridViewAutoSizeRowsMode

Property Value


크기 조정 모드를 나타내는 DataGridViewAutoSizeRowsMode 값입니다.A DataGridViewAutoSizeRowsMode value indicating the sizing mode. 기본값은 None입니다.The default is None.


이 속성을 설정할 때 지정된 값이 유효한 DataGridViewAutoSizeRowsMode 값이 아닙니다.The specified value when setting this property is not a valid DataGridViewAutoSizeRowsMode value.

이 속성을 설정할 때 지정된 값이 AllHeaders 또는 DisplayedHeaders이고 행 머리글이 숨겨져 있습니다.The specified value when setting this property is AllHeaders or DisplayedHeaders and row headers are hidden.


다음 코드 예제에는 행의 모든 열 및 행 머리글의 내용에 따라 자동으로 크기 조정 설정 하는 방법을 보여 줍니다.The following code example demonstrates how to set the row to automatically resize based on the contents of the row headers and all of the columns. 이 코드 예제는에서 제공 하는 더 큰 예제의 일부입니다 방법: 자동으로 크기를 조정 셀 변경 될 때 콘텐츠는 Windows Forms DataGridView 컨트롤에서합니다.This code example is part of a larger example provided in How to: Automatically Resize Cells When Content Changes in the Windows Forms DataGridView Control.

void AutoSizeRowsMode( Object^ /*sender*/, EventArgs^ /*es*/ )
   dataGridView1->AutoSizeRowsMode = DataGridViewAutoSizeRowsMode::AllCells;
private void AutoSizeRowsMode(Object sender, EventArgs es)
    dataGridView1.AutoSizeRowsMode =
Private Sub AutoSizeRowsMode(ByVal sender As Object, _
    ByVal e As System.EventArgs) Handles Button7.Click

    DataGridView1.AutoSizeRowsMode = _

End Sub


이 속성에는 내용이 변경 될 때마다 해당 내용에 맞게 행 높이가 자동으로 조정 됩니다 있도록 컨트롤을 구성할 수 있습니다.This property lets you configure the control so that row heights are automatically adjusted to fit their contents whenever the contents change. WrapMode 사용 하도록 설정 된 경우 열 너비가 변경 될 때마다 행 높이도 조정 됩니다.If WrapMode is enabled, row heights are also adjusted whenever column widths change. 일부 크기 조정 모드 성능을 높이기 위해 크기 조정 하면 현재 표시 된 행을 제한할 수 있습니다.Some sizing modes let you limit the size adjustment to the currently displayed rows in order to increase performance.

Visible 속성 값이 true 인 행만 자동으로 크기가 조정 되 고 행의 표시 유형을 변경 해도 크기 조정을 발생 시 키 지 않습니다.Only rows with a Visible property value of true are resized automatically, and changing the visibility of a row does not cause resizing to occur. 또한 행을 자동으로 조정 되도록 설정 하면 사용자는 마우스를 사용 하 여 행 높이 조정할 수 없습니다.Additionally, when rows are set to automatically resize, the user cannot adjust the row heights with the mouse.

자동 크기 조정 된 행의 Height 값은 레이아웃 중에 사용 되는 글꼴 크기를 고려 하 여 다시 계산 됩니다.The Height value of an automatically sized row is recalculated during layout to account for the size of the font that is used. 올바른 Height를 가져오려면 폼의 생성자 대신 폼의 Layout 이벤트에서 값을 검색 해야 합니다.To get the correct Height, you should retrieve the value in the form's Layout event instead of in the form's constructor.

행 높이를 프로그래밍 방식으로 조정 하려면 AutoResizeRow 또는 AutoResizeRows 메서드를 사용 하거나 행 Height 속성을 설정 합니다.To adjust row heights programmatically, use the AutoResizeRow or AutoResizeRows methods, or set the row Height property.

행의 크기를 조정할 때 셀 내용이 여러 줄로 줄 바꿈되는 경우 셀에 적용 되는 셀 스타일에는 TrueWrapMode 속성 값이 있어야 합니다.For cell contents to wrap onto multiple lines when a row is resized, the cell style in effect for the cell must have a WrapMode property value of True.

내용 기반 자동 크기 조정에 대 한 자세한 내용은 Windows Forms DataGridView 컨트롤의 크기 조정 옵션을 참조 하세요.For more information about content-based automatic sizing, see Sizing Options in the Windows Forms DataGridView Control.

Applies to

See also