DataGridViewColumn.AutoSizeMode 속성

정의

열의 너비를 자동으로 조정하는 모드를 가져오거나 설정합니다.Gets or sets the mode by which the column automatically adjusts its width.

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

속성 값

열의 너비가 자동으로 조정되는지 여부와 열의 기본 설정 너비를 결정하는 방법을 나타내는 DataGridViewAutoSizeColumnMode 값입니다.A DataGridViewAutoSizeColumnMode value that determines whether the column will automatically adjust its width and how it will determine its preferred width. 기본값은 NotSet입니다.The default is NotSet.

예외

이 속성을 설정할 때 지정된 값이 잘못된 DataGridViewAutoSizeColumnMode인 경우The specified value when setting this property is a DataGridViewAutoSizeColumnMode that is not valid.

이 속성을 설정할 때 지정된 값으로 인해 열 머리글이 숨겨질 때 표시되는 열의 InheritedAutoSizeMode 값이 ColumnHeader가 되는 경우The specified value when setting this property results in an InheritedAutoSizeMode value of ColumnHeader for a visible column when column headers are hidden.

또는-or- 이 속성을 설정할 때 지정된 값으로 인해 고정되어 있는 표시되는 열의 InheritedAutoSizeMode 값이 Fill이 되는 경우The specified value when setting this property results in an InheritedAutoSizeMode value of Fill for a visible column that is frozen.

예제

다음 코드 예제에서는 열 내용에 맞게 너비가 자동으로 조정 되도록 합니다.The following code example forces a column to automatically resize its width to fit its contents. 이 코드 예제는에 대해 제공 된 큰 예제의 일부는 DataGridViewColumn 클래스입니다.This code example is part of a larger example provided for the DataGridViewColumn class.

// AutoSize the third column.
void Button6_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
{
   DataGridViewColumn^ column = dataGridView->Columns[ 2 ];
   column->AutoSizeMode = DataGridViewAutoSizeColumnMode::DisplayedCells;
}


// AutoSize the third column.
private void Button6_Click(object sender,
    System.EventArgs e)
{
    DataGridViewColumn column = dataGridView.Columns[2];
    column.AutoSizeMode = DataGridViewAutoSizeColumnMode.DisplayedCells;
}
' AutoSize the third column.
Private Sub Button6_Click(ByVal sender As Object, _
    ByVal e As System.EventArgs) Handles Button6.Click

    Dim column As DataGridViewColumn = dataGridView.Columns(2)
    column.AutoSizeMode = DataGridViewAutoSizeColumnMode.DisplayedCells
End Sub

설명

열 자동 크기 조정 동작의 값에 따라 결정 됩니다는 InheritedAutoSizeMode 속성 값으로 동일한의 합니다 AutoSizeMode 를 제외한 모든 값에 대 한 속성 NotSet, 합니다 에서값이상속됨을나타내는DataGridView.AutoSizeColumnsMode속성 대신 합니다.The automatic sizing behavior of the column is determined by the value of the InheritedAutoSizeMode property, which is the same as the value of the AutoSizeMode property for all values except NotSet, which indicates that the value is inherited from the DataGridView.AutoSizeColumnsMode property instead.

경우는 InheritedAutoSizeMode 속성 값이 Fill, 해당 모드에서 다른 열과 함께 사용 하는 열에서 크기를 조정 합니다.When the InheritedAutoSizeMode property value is Fill, the column is resized along with other columns in that mode. 컨트롤의 모든 채우기 모드 열 분할 사용 가능한 공간 비율에 따른 해당 FillWeight 속성 값입니다.All fill-mode columns in the control divide the available space in proportions determined by their FillWeight property values. 채우기 모드에 대 한 사용 가능한 너비는 컨트롤의 클라이언트 영역 너비에서 다른 모든 열의 너비를 뺀 값으로 결정 됩니다.The width available for fill mode is determined by subtracting the widths of all other columns from the width of the client area of the control. 이 너비는 결합 된 보다 작은 경우 MinimumWidth 모든 채우기 모드 열 값, 가로 스크롤 막대가 표시 됩니다, 모든 채우기 모드 열의 최소 너비를 사용 하 여 표시 됩니다 및 사용자 열 크기 조정 사용 하지 않도록 설정 합니다.If this width is smaller than the combined MinimumWidth values of all fill-mode columns, the horizontal scroll bar is displayed, all fill-mode columns are shown with their minimum widths, and user column-resizing is disabled. 열 채우기 모드에 대 한 자세한 내용은 참조 하세요. Windows Forms DataGridView 컨트롤의 열 채우기 모드합니다.For more information about column fill mode, see Column Fill Mode in the Windows Forms DataGridView Control.

경우는 InheritedAutoSizeMode 속성은 제외 하 고 다른 값으로 None, 해당 셀 값 잘림 없이 완전히 표시 되도록 열 너비를 관리 합니다.When the InheritedAutoSizeMode property is set to any other value except None, the column will manage its width so that its cell values are fully displayed without clipping. 콘텐츠 기반 크기 조정 모드에서는 크기 조정 셀 내용이 변경 될 때마다 또는 경우에 발생할 WrapMode 행 높이가 변경 될 때마다 사용 됩니다.In content-based sizing modes, size adjustments occur whenever cell contents change or, if WrapMode is enabled, whenever row heights change. 일부 콘텐츠 기반 크기 조정 모드 성능을 높이기 위해 크기 조정 하면 현재 표시 된 행을 제한할 수 있습니다.Some content-based sizing modes let you limit the size adjustment to the currently displayed rows in order to increase performance.

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

열 너비를 프로그래밍 방식으로 조정 하려면 사용 합니다 DataGridView 컨트롤의 AutoResizeColumn 또는 AutoResizeColumns 메서드 또는 열 집합 Width 속성입니다.To adjust column widths programmatically, use the DataGridView control's AutoResizeColumn or AutoResizeColumns methods or set the column Width property.

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

적용 대상

추가 정보