DataGridViewAutoSizeColumnsMode 열거형

정의

열의 너비를 조정하는 방법을 지정하는 값을 정의합니다.Defines values for specifying how the widths of columns are adjusted.

public enum class DataGridViewAutoSizeColumnsMode
public enum DataGridViewAutoSizeColumnsMode
type DataGridViewAutoSizeColumnsMode = 
Public Enum DataGridViewAutoSizeColumnsMode
상속
DataGridViewAutoSizeColumnsMode

필드

AllCells 6

머리글 셀을 포함하여 열에 있는 모든 셀의 내용에 맞도록 열 너비가 조정됩니다.The column widths adjust to fit the contents of all cells in the columns, including header cells.

AllCellsExceptHeader 4

머리글 셀을 제외하고 열에 있는 모든 셀의 내용에 맞도록 열 너비가 조정됩니다.The column widths adjust to fit the contents of all cells in the columns, excluding header cells.

ColumnHeader 2

열 머리글 셀의 내용에 맞도록 열 너비가 조정됩니다.The column widths adjust to fit the contents of the column header cells.

DisplayedCells 10

머리글 셀을 포함하여 현재 화면에 표시된 행의 열에 있는 모든 셀의 내용에 맞도록 열 너비가 조정됩니다.The column widths adjust to fit the contents of all cells in the columns that are in rows currently displayed onscreen, including header cells.

DisplayedCellsExceptHeader 8

머리글 셀을 제외하고 현재 화면에 표시된 행의 열에 있는 모든 셀의 내용에 맞도록 열 너비가 조정됩니다.The column widths adjust to fit the contents of all cells in the columns that are in rows currently displayed onscreen, excluding header cells.

Fill 16

모든 열의 너비가 컨트롤의 표시 영역을 정확히 채우도록 열 너비가 조정됩니다. MinimumWidth 속성 값 이상으로 열 너비를 유지해야 할 경우에만 가로 스크롤이 필요합니다.The column widths adjust so that the widths of all columns exactly fill the display area of the control, requiring horizontal scrolling only to keep column widths above the MinimumWidth property values. 상대 열 너비는 상대 FillWeight 속성 값에 의해 결정됩니다.Relative column widths are determined by the relative FillWeight property values.

None 1

열 너비가 자동으로 조정되지 않습니다.The column widths do not automatically adjust.

예제

다음 코드 예제에서는 두 개의 마스터/세부 정보 시나리오에서이 열거형의 사용을 보여 줍니다 DataGridView 컨트롤이 부모/자식 관계에서 두 테이블에서 데이터를 표시 합니다.The following code example illustrates the use of this enumeration in a master/details scenario where two DataGridView controls display data from two tables in a parent/child relationship. 이 예제에서는 마스터 컨트롤에 대 한 열 크기 조정 모드가 None이 고 열 너비 로드 된 값에 맞게 프로그래밍 방식으로 초기화 됩니다.In this example, the column sizing mode for the master control is None and the column widths are programmatically initialized to fit the loaded values. 세부 컨트롤 (예를 들어 사용자가 변경할 때 부모 테이블의 현재 행) 값이 변경 될 때마다 열이 자동으로 조정 되도록 자동 크기 조정 모드로 설정 됩니다.The details control is set to an automatic sizing mode so that columns will adjust automatically whenever the values change (for example, when the user changes the current row in the parent table). 이 예제는에서 사용할 수 있는 보다 큰 예제의 일부 방법:는 마스터/세부 폼 사용 하 여 두 개의 Windows Forms DataGridView 컨트롤 만들기합니다.This example is part of a larger example available in How to: Create a Master/Detail Form Using Two Windows Forms DataGridView Controls.

private void Form1_Load(object sender, System.EventArgs e)
{
    // Bind the DataGridView controls to the BindingSource
    // components and load the data from the database.
    masterDataGridView.DataSource = masterBindingSource;
    detailsDataGridView.DataSource = detailsBindingSource;
    GetData();

    // Resize the master DataGridView columns to fit the newly loaded data.
    masterDataGridView.AutoResizeColumns();

    // Configure the details DataGridView so that its columns automatically
    // adjust their widths when the data changes.
    detailsDataGridView.AutoSizeColumnsMode = 
        DataGridViewAutoSizeColumnsMode.AllCells;
}
Private Sub Form1_Load(ByVal sender As Object, ByVal e As System.EventArgs) _
    Handles Me.Load

    ' Bind the DataGridView controls to the BindingSource
    ' components and load the data from the database.
    masterDataGridView.DataSource = masterBindingSource
    detailsDataGridView.DataSource = detailsBindingSource
    GetData()

    ' Resize the master DataGridView columns to fit the newly loaded data.
    masterDataGridView.AutoResizeColumns()

    ' Configure the details DataGridView so that its columns automatically
    ' adjust their widths when the data changes.
    detailsDataGridView.AutoSizeColumnsMode = _
        DataGridViewAutoSizeColumnsMode.AllCells

End Sub

설명

DataGridView 컨트롤 컨트롤의 사용 가능한 가로 너비를 채울 수 있도록 하거나 지정 된 셀 또는 셀을 모두의 전체 내용을 표시할 수 있도록 해당 열의 크기를 조정할 수 있습니다.The DataGridView control can resize its columns to make them fill the available horizontal width of the control or to make them display the full contents of all cells or of specified cells.

사용 하 여 Fill 모드, 기본 설정된 너비 열 컨트롤에 표시 되는 모든 열에는 정확 하 게 사용 가능한 표시 영역의 가로 너비를 채우도록 해당 모드에 있는 모든 열의 크기를 조정 하 여 결정 됩니다.With Fill mode, the preferred width of a column is determined by resizing all columns in that mode so that all visible columns in the control exactly fill the horizontal width of the available display area. 기본 열 너비는 다른 모드를 사용 하 여 현재 표시 된 행에 있는 셀의 하위 집합을 같은 열에 있는 모든 셀 또는 셀의 하위 집합의 가장 큰 셀 값을 표시 하는 데 필요한 최소 너비가입니다.With other modes, the preferred column width is the minimum width required to display the largest cell value from all cells or a subset of cells in that column, such as the subset of cells that are in currently displayed rows. 셀의 하위 집합을 사용 하 여 새 너비를 확인 하는 것은 많은 데이터 행을 작업할 때 성능 저하를 방지 하려면 유용 합니다.Using a subset of cells to determine the new width is useful to avoid a performance penalty when working with many rows of data.

콘텐츠 기반 자동 크기 조정은 사용자를가 마우스로 열 너비를 조정할 수 없습니다.Content-based automatic resizing prevents users from adjusting column widths with the mouse. 사용자 크기 조정 가능 채우기 모드에 있지만.User resizing is enabled in fill mode, however.

이 열거형은에서 사용 된 DataGridView 제어 AutoSizeColumnsMode 속성 및 AutoResizeColumns 메서드.This enumeration is used by the DataGridView control AutoSizeColumnsMode property and AutoResizeColumns method.

크기 조정 모드에 대 한 자세한 내용은 참조 하세요. Windows Forms DataGridView 컨트롤의 크기 조정 옵션합니다.For more information about sizing modes, see Sizing Options in the Windows Forms DataGridView Control. 열 채우기 모드에 대 한 자세한 내용은 참조 특히 Windows Forms DataGridView 컨트롤의 열 채우기 모드합니다.For more information about column fill mode in particular, see Column Fill Mode in the Windows Forms DataGridView Control.

적용 대상

추가 정보