이 설명서는 보관되지만 유지 되지 않습니다.

DataGridView.AutoSizeColumnsMode 속성

업데이트: 2007년 11월

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

네임스페이스:  System.Windows.Forms
어셈블리:  System.Windows.Forms(System.Windows.Forms.dll)

public DataGridViewAutoSizeColumnsMode AutoSizeColumnsMode { get; set; }
/** @property */
public DataGridViewAutoSizeColumnsMode get_AutoSizeColumnsMode()
/** @property */
public  void set_AutoSizeColumnsMode(DataGridViewAutoSizeColumnsMode value)

public function get AutoSizeColumnsMode () : DataGridViewAutoSizeColumnsMode
public function set AutoSizeColumnsMode (value : DataGridViewAutoSizeColumnsMode)

속성 값

형식: System.Windows.Forms.DataGridViewAutoSizeColumnsMode

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

예외상황
InvalidEnumArgumentException

이 속성을 설정할 때 지정된 값이 올바른 DataGridViewAutoSizeColumnsMode 값이 아닌 경우

InvalidOperationException

이 속성을 설정할 때 지정된 값이 ColumnHeader이고 열 머리글이 숨겨져 있으며 적어도 하나의 표시된 열에서 AutoSizeMode 속성 값이 NotSet인 경우

- 또는 -

이 속성을 설정할 때 지정된 값이 Fill이고 AutoSizeMode 속성 값이 NotSet인 하나 이상의 표시된 열이 고정된 경우

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

개별 열에 대한 크기 조정 모드를 변경하려면 해당 AutoSizeMode 속성을 설정합니다. 이 속성의 기본값은 NotSet이며, 이것은 열이 컨트롤로부터 해당 동작과 InheritedAutoSizeMode 속성 값을 상속함을 의미합니다.

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

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

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

내용을 기반으로 한 자동 크기 조정에 대한 자세한 내용은 Windows Forms DataGridView 컨트롤의 크기 조정 옵션을 참조하십시오.

다음 코드 예제에서는 부모/자식 관계인 두 테이블의 데이터를 두 개의 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;
}


Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

.NET Framework 및 .NET Compact Framework에서 모든 플랫폼의 전체 버전을 지원하지는 않습니다. 지원되는 버전의 목록을 보려면 .NET Framework 시스템 요구 사항을 참조하십시오.

.NET Framework

3.5, 3.0, 2.0에서 지원
표시: