DataGridViewColumn.AutoSizeMode 속성

  • 참조

정의

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

열의 너비를 자동으로 조정하는 모드를 가져오거나 설정합니다.

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

열의 너비가 자동으로 조정되는지 여부와 열의 기본 설정 너비를 결정하는 방법을 나타내는 DataGridViewAutoSizeColumnMode 값입니다. 기본값은 NotSet입니다.

예외

InvalidEnumArgumentException

이 속성을 설정할 때 지정된 값이 잘못된 DataGridViewAutoSizeColumnMode인 경우

InvalidOperationException

이 속성을 설정할 때 지정된 값으로 인해 열 머리글이 숨겨질 때 표시되는 열의 InheritedAutoSizeMode 값이 ColumnHeader가 되는 경우

또는 이 속성을 설정할 때 지정된 값으로 인해 고정되어 있는 표시되는 열의 InheritedAutoSizeMode 값이 Fill이 되는 경우

예제

다음 코드 예제에서는 열이 내용에 맞게 너비의 크기를 자동으로 조정하도록 합니다. 이 코드 예제는에 대해 제공 된 큰 예제의 일부는 DataGridViewColumn 클래스입니다.

// 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 에 의해 결정됩니다. 속성 값은 속성에서 DataGridView.AutoSizeColumnsMode 상속됨을 나타내는 값을 제외한 NotSet모든 값의 AutoSizeMode 속성 값과 동일합니다.

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

InheritedAutoSizeMode 속성을 제외한 None다른 값으로 설정하면 해당 셀 값이 클리핑 없이 완전히 표시되도록 열이 너비를 관리합니다. 콘텐츠 기반 크기 조정 모드에서는 셀 내용이 변경되거나 WrapMode 행 높이가 변경될 때마다 크기 조정이 수행됩니다. 일부 콘텐츠 기반 크기 조정 모드를 사용하면 성능을 높이기 위해 현재 표시된 행으로 크기 조정을 제한할 수 있습니다.

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

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

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

적용 대상

추가 정보