DataGridView.AutoResizeColumn 메서드

  • 참조

정의

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

지정된 열의 너비를 셀의 내용에 맞게 조정합니다.

오버로드

AutoResizeColumn(Int32)

머리글 셀을 비롯한 모든 셀의 내용에 맞게, 지정된 열의 너비를 조정합니다.
AutoResizeColumn(Int32, DataGridViewAutoSizeColumnMode)

지정된 크기 모드를 사용하여 지정된 열의 너비를 조정합니다.
AutoResizeColumn(Int32, DataGridViewAutoSizeColumnMode, Boolean)

지정된 크기 모드를 사용하고 필요한 경우 행 높이가 조정될 것이란 가정하에 너비를 계산하여 지정된 열의 너비를 조정합니다.

AutoResizeColumn(Int32)

머리글 셀을 비롯한 모든 셀의 내용에 맞게, 지정된 열의 너비를 조정합니다.

public:
 void AutoResizeColumn(int columnIndex);
public void AutoResizeColumn (int columnIndex);
member this.AutoResizeColumn : int -> unit
Public Sub AutoResizeColumn (columnIndex As Integer)

매개 변수

columnIndex
Int32

크기를 조정할 열의 인덱스입니다.

예외

ArgumentOutOfRangeException

columnIndex가 0부터 열 수-1 사이에 속하지 않습니다.

예제

다음 코드 예제에서는 이 메서드를 사용하여 새 셀 값을 수용할 수 있을 만큼 열 너비를 크게 만듭니다. 이 예제는 방법: Windows Forms DataGridView 컨트롤의 행 조작에서 사용할 수 있는 더 큰 예제의 일부입니다.

// Give cheescake excellent rating.
void Button8_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
{
   UpdateStars( dataGridView->Rows[ 4 ], L"******************" );
}

int ratingColumn;
void UpdateStars( DataGridViewRow^ row, String^ stars )
{
   row->Cells[ ratingColumn ]->Value = stars;
   
   // Resize the column width to account for the new value.
   row->DataGridView->AutoResizeColumn( ratingColumn, DataGridViewAutoSizeColumnMode::DisplayedCells );
}

// Give cheescake excellent rating.
private void Button8_Click(object sender,
    System.EventArgs e)
{
    UpdateStars(dataGridView.Rows[4], "******************");
}

int ratingColumn = 3;

private void UpdateStars(DataGridViewRow row, string stars)
{

    row.Cells[ratingColumn].Value = stars;

    // Resize the column width to account for the new value.
    row.DataGridView.AutoResizeColumn(ratingColumn, 
        DataGridViewAutoSizeColumnMode.DisplayedCells);
}

' Give cheescake excellent rating.
Private Sub Button8_Click(ByVal sender As Object, _
    ByVal e As System.EventArgs) Handles Button8.Click

    UpdateStars(dataGridView.Rows(4), "******************")
End Sub

Private ratingColumn As Integer = 3

Private Sub UpdateStars(ByVal row As DataGridViewRow, _
    ByVal stars As String)

    row.Cells(ratingColumn).Value = stars

    ' Resize the column width to account for the new value.
    row.DataGridView.AutoResizeColumn(ratingColumn, _
        DataGridViewAutoSizeColumnMode.DisplayedCells)

End Sub

설명

이 메서드는 열의 크기가 조정되는 시기를 제어하려는 경우에 유용합니다. 열 너비는 메서드 호출당 한 번만 조정됩니다. 나중에 열 내용이 변경되면 열이 자동으로 조정되지 않습니다. 모든 열의 크기를 조정하려면 메서드를 AutoResizeColumns 사용합니다. 열의 내용이 변경 될 때마다 자동으로 크기를 조정 하도록 설정 하려면 속성 또는 열 AutoSizeMode 속성을 사용 합니다AutoSizeColumnsMode.

프로그래밍 방식 크기 조정에 대한 자세한 내용은 Windows Forms DataGridView 컨트롤의 크기 조정 옵션을 참조하세요.

추가 정보

적용 대상

AutoResizeColumn(Int32, DataGridViewAutoSizeColumnMode)

지정된 크기 모드를 사용하여 지정된 열의 너비를 조정합니다.

public:
 void AutoResizeColumn(int columnIndex, System::Windows::Forms::DataGridViewAutoSizeColumnMode autoSizeColumnMode);
public void AutoResizeColumn (int columnIndex, System.Windows.Forms.DataGridViewAutoSizeColumnMode autoSizeColumnMode);
member this.AutoResizeColumn : int * System.Windows.Forms.DataGridViewAutoSizeColumnMode -> unit
Public Sub AutoResizeColumn (columnIndex As Integer, autoSizeColumnMode As DataGridViewAutoSizeColumnMode)

매개 변수

columnIndex
Int32

크기를 조정할 열의 인덱스입니다.

autoSizeColumnMode
DataGridViewAutoSizeColumnMode

DataGridViewAutoSizeColumnMode 값 중 하나입니다.

예외

InvalidOperationException

autoSizeColumnMode는 값이 ColumnHeader이며 ColumnHeadersVisible은 false입니다.

ArgumentException

autoSizeColumnMode는 값이 NotSet, None 또는 Fill입니다.

ArgumentOutOfRangeException

columnIndex가 0부터 열 수-1 사이에 속하지 않습니다.

InvalidEnumArgumentException

autoSizeColumnMode는 유효한 DataGridViewAutoSizeColumnMode 값이 아닙니다.

예제

다음 코드 예제에서는 이 메서드를 사용하여 새 셀 값을 수용할 수 있을 만큼 열 너비를 크게 만듭니다. 이 예제는 방법: Windows Forms DataGridView 컨트롤의 행 조작에서 사용할 수 있는 더 큰 예제의 일부입니다.

// Give cheescake excellent rating.
void Button8_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
{
   UpdateStars( dataGridView->Rows[ 4 ], L"******************" );
}

int ratingColumn;
void UpdateStars( DataGridViewRow^ row, String^ stars )
{
   row->Cells[ ratingColumn ]->Value = stars;
   
   // Resize the column width to account for the new value.
   row->DataGridView->AutoResizeColumn( ratingColumn, DataGridViewAutoSizeColumnMode::DisplayedCells );
}

// Give cheescake excellent rating.
private void Button8_Click(object sender,
    System.EventArgs e)
{
    UpdateStars(dataGridView.Rows[4], "******************");
}

int ratingColumn = 3;

private void UpdateStars(DataGridViewRow row, string stars)
{

    row.Cells[ratingColumn].Value = stars;

    // Resize the column width to account for the new value.
    row.DataGridView.AutoResizeColumn(ratingColumn, 
        DataGridViewAutoSizeColumnMode.DisplayedCells);
}

' Give cheescake excellent rating.
Private Sub Button8_Click(ByVal sender As Object, _
    ByVal e As System.EventArgs) Handles Button8.Click

    UpdateStars(dataGridView.Rows(4), "******************")
End Sub

Private ratingColumn As Integer = 3

Private Sub UpdateStars(ByVal row As DataGridViewRow, _
    ByVal stars As String)

    row.Cells(ratingColumn).Value = stars

    ' Resize the column width to account for the new value.
    row.DataGridView.AutoResizeColumn(ratingColumn, _
        DataGridViewAutoSizeColumnMode.DisplayedCells)

End Sub

설명

이 메서드는 열의 크기가 조정되는 시기를 제어하려는 경우에 유용합니다. 열 너비는 메서드 호출당 한 번만 조정됩니다. 나중에 열 내용이 변경되면 열이 자동으로 조정되지 않습니다. 모든 열의 크기를 조정하려면 메서드를 AutoResizeColumns 사용합니다. 열의 내용이 변경 될 때마다 자동으로 크기를 조정 하도록 설정 하려면 속성 또는 열 AutoSizeMode 속성을 사용 합니다AutoSizeColumnsMode.

이 오버로드를 사용하면 표시된 행에만 있는 셀과 같이 제한된 셀 집합의 값에 따라 새 너비를 계산하는 크기 조정 모드를 지정할 수 있습니다. 이렇게 하면 컨트롤에 많은 수의 행이 포함된 경우 성능이 향상됩니다.

프로그래밍 방식 크기 조정에 대한 자세한 내용은 Windows Forms DataGridView 컨트롤의 크기 조정 옵션을 참조하세요.

추가 정보

적용 대상

AutoResizeColumn(Int32, DataGridViewAutoSizeColumnMode, Boolean)

지정된 크기 모드를 사용하고 필요한 경우 행 높이가 조정될 것이란 가정하에 너비를 계산하여 지정된 열의 너비를 조정합니다.

protected:
 void AutoResizeColumn(int columnIndex, System::Windows::Forms::DataGridViewAutoSizeColumnMode autoSizeColumnMode, bool fixedHeight);
protected void AutoResizeColumn (int columnIndex, System.Windows.Forms.DataGridViewAutoSizeColumnMode autoSizeColumnMode, bool fixedHeight);
member this.AutoResizeColumn : int * System.Windows.Forms.DataGridViewAutoSizeColumnMode * bool -> unit
Protected Sub AutoResizeColumn (columnIndex As Integer, autoSizeColumnMode As DataGridViewAutoSizeColumnMode, fixedHeight As Boolean)

매개 변수

columnIndex
Int32

크기를 조정할 열의 인덱스입니다.

autoSizeColumnMode
DataGridViewAutoSizeColumnMode

DataGridViewAutoSizeColumnMode 값 중 하나입니다.

fixedHeight
Boolean

현재 행 높이를 기준으로 새 너비를 계산하려면 true이고, 행 높이도 조정될 것이란 가정하에 너비를 계산하려면 false입니다.

예외

InvalidOperationException

autoSizeColumnMode는 값이 ColumnHeader이며 ColumnHeadersVisible은 false입니다.

ArgumentException

autoSizeColumnMode는 값이 NotSet, None 또는 Fill입니다.

ArgumentOutOfRangeException

columnIndex가 0부터 열 수-1 사이에 속하지 않습니다.

InvalidEnumArgumentException

autoSizeColumnMode는 유효한 DataGridViewAutoSizeColumnMode 값이 아닙니다.

설명

이 메서드는 열의 크기가 조정되는 시기를 제어하려는 경우에 유용합니다. 열 너비는 메서드 호출당 한 번만 조정됩니다. 나중에 열 내용이 변경되면 열이 자동으로 조정되지 않습니다. 모든 열의 크기를 조정하려면 메서드를 AutoResizeColumns 사용합니다. 열의 내용이 변경 될 때마다 자동으로 크기를 조정 하도록 설정 하려면 속성 또는 열 AutoSizeMode 속성을 사용 합니다AutoSizeColumnsMode.

이 오버로드를 사용하면 표시된 행에만 있는 셀과 같이 제한된 셀 집합의 값에 따라 새 너비를 계산하는 크기 조정 모드를 지정할 수 있습니다. 이렇게 하면 컨트롤에 많은 수의 행이 포함된 경우 성능이 향상됩니다.

이 오버로드는 보호되며 파생 DataGridView 클래스에서 이상적인 셀 높이 대 너비 비율을 달성할 수 있도록 설계되었습니다. 이 false경우 fixedHeight 열 너비는 다음에 또는 AutoResizeRows 메서드를 호출 AutoResizeRow 할 것으로 예상하여 계산됩니다.

프로그래밍 방식 크기 조정에 대한 자세한 내용은 Windows Forms DataGridView 컨트롤의 크기 조정 옵션을 참조하세요.

추가 정보

적용 대상