DataGridView.AutoSizeColumnsMode 속성

정의

네임스페이스:

System.Windows.Forms

어셈블리:

System.Windows.Forms.dll

열 너비의 결정 방식을 지정하는 값을 가져오거나 설정합니다.

public:
 property System::Windows::Forms::DataGridViewAutoSizeColumnsMode AutoSizeColumnsMode { System::Windows::Forms::DataGridViewAutoSizeColumnsMode get(); void set(System::Windows::Forms::DataGridViewAutoSizeColumnsMode value); };

public System.Windows.Forms.DataGridViewAutoSizeColumnsMode AutoSizeColumnsMode { get; set; }

member this.AutoSizeColumnsMode : System.Windows.Forms.DataGridViewAutoSizeColumnsMode with get, set

Public Property AutoSizeColumnsMode As DataGridViewAutoSizeColumnsMode

속성 값

DataGridViewAutoSizeColumnsMode

DataGridViewAutoSizeColumnsMode 값입니다. 기본값은 None입니다.

예외

InvalidEnumArgumentException

이 속성을 설정할 때 지정된 값이 유효한 DataGridViewAutoSizeColumnsMode 값이 아닙니다.

InvalidOperationException

이 속성을 설정할 때 지정된 값이 ColumnHeader이고, 열 머리글이 숨겨져 있고, 표시된 하나 이상의 열이 AutoSizeMode 속성 값 NotSet을 갖습니다.

또는 이 속성을 설정할 때 지정된 값이 Fill이고 AutoSizeMode 속성 값 NotSet을 갖는 표시된 하나 이상의 열이 고정되어 있습니다.

예제

다음 코드 예제에서는 두 컨트롤 부모/자식 관계에 있는 두 DataGridView 테이블의 데이터를 표시 하는 마스터/세부 정보 시나리오에서이 속성을 사용 하는 방법을 보여 줍니다. 이 예제에서 마스터 컨트롤의 열 크기 조정 모드는 None로드된 값에 맞게 프로그래밍 방식으로 초기화됩니다. 세부 정보 컨트롤은 값이 변경될 때마다 열이 자동으로 조정되도록 자동 열 크기 조정 모드로 설정됩니다(예: 사용자가 부모 테이블의 현재 행을 변경하는 경우). 이 예제는에서 사용할 수 있는 보다 큰 예제의 일부 방법:는 마스터/세부 폼 사용 하 여 두 개의 Windows Forms DataGridView 컨트롤 만들기합니다.

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

설명

이 속성을 사용하면 컨트롤을 채우거나 셀 내용에 맞게 열 너비가 자동으로 조정되도록 컨트롤을 구성할 수 있습니다. 크기 조정은 컨트롤의 너비가 변경 될 때마다 채우기 모드에서 발생합니다. 콘텐츠 기반 크기 조정 모드에서는 셀 내용이 변경되거나 WrapMode 행 높이가 변경될 때마다 크기 조정이 수행됩니다. 일부 콘텐츠 기반 크기 조정 모드를 사용하면 성능을 높이기 위해 현재 표시된 행으로 크기 조정을 제한할 수 있습니다.

개별 열의 크기 조정 모드를 변경하려면 해당 AutoSizeMode 속성을 설정합니다. 이 속성의 기본값은 NotSet열이 컨트롤에서 해당 동작 및 해당 InheritedAutoSizeMode 속성 값을 상속함을 나타내는 것입니다.

채우기 모드의 열은 사용 가능한 컨트롤 너비를 해당 속성 값으로 FillWeight 표시된 비율로 나눕니다. 채우기 모드에 사용할 수 있는 너비는 컨트롤의 클라이언트 영역 너비에서 다른 모든 열의 너비를 빼서 결정됩니다. 이 너비가 모든 채우기 모드 열의 결합된 MinimumWidth 값보다 작으면 가로 스크롤 막대가 표시되고, 모든 채우기 모드 열이 최소 너비로 표시되고, 사용자 열 크기 조정이 비활성화됩니다. 열 채우기 모드에 대한 자세한 내용은 Windows Forms DataGridView 컨트롤의 열 채우기 모드를 참조하세요.

속성 값 true 이 있는 Visible 열만 자동으로 크기가 조정되며 열의 표시 유형을 변경해도 크기 조정이 발생하지 않습니다. 또한 열의 크기를 자동으로 조정하도록 설정하면 사용자가 마우스로 열 너비를 조정할 수 없습니다.

프로그래밍 방식으로 열 너비를 조정하려면 또는 메서드를 AutoResizeColumn 사용하거나 AutoResizeColumns 열 Width 속성을 설정합니다.

콘텐츠 기반 자동 크기 조정에 대한 자세한 내용은 Windows Forms DataGridView 컨트롤의 크기 조정 옵션을 참조하세요.

추가 정보

• DataGridViewAutoSizeColumnsMode
• FillWeight
• DataGridView 컨트롤(Windows Forms)