DataGridView.AutoResizeColumn 메서드

정의

지정된 열의 너비를 셀의 내용에 맞게 조정합니다.Adjusts the width of the specified column to fit the contents of its cells.

오버로드

AutoResizeColumn(Int32)

머리글 셀을 비롯한 모든 셀의 내용에 맞게, 지정된 열의 너비를 조정합니다.Adjusts the width of the specified column to fit the contents of all its cells, including the header cell.

AutoResizeColumn(Int32, DataGridViewAutoSizeColumnMode)

지정된 크기 모드를 사용하여 지정된 열의 너비를 조정합니다.Adjusts the width of the specified column using the specified size mode.

AutoResizeColumn(Int32, DataGridViewAutoSizeColumnMode, Boolean)

지정된 크기 모드를 사용하고 필요한 경우 행 높이가 조정될 것이란 가정하에 너비를 계산하여 지정된 열의 너비를 조정합니다.Adjusts the width of the specified column using the specified size mode, optionally calculating the width with the expectation that row heights will subsequently be adjusted.

AutoResizeColumn(Int32)

머리글 셀을 비롯한 모든 셀의 내용에 맞게, 지정된 열의 너비를 조정합니다.Adjusts the width of the specified column to fit the contents of all its cells, including the header cell.

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

매개 변수

columnIndex
Int32

크기를 조정할 열의 인덱스입니다.The index of the column to resize.

예외

columnIndex가 0부터 열 수-1 사이에 속하지 않습니다.columnIndex is not in the valid range of 0 to the number of columns minus 1.

예제

다음 코드 예제에서는이 메서드를 사용 하 여 새 셀 값에 맞게 충분히 큰 열 너비를 확인 합니다.The following code example uses this method to make the column width large enough to accommodate a new cell value. 이 예제는 방법: DataGridView 컨트롤 Windows Forms에서 행 조작에서 사용할 수 있는 더 큰 예제의 일부입니다.This example is part of a larger example available in How to: Manipulate Rows in the Windows Forms DataGridView Control.

// 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

설명

이 메서드는 열 크기를 조정 하는 시기를 제어 하려는 경우에 유용 합니다.This method is useful if you want to control when a column resizes. 열 너비를 메서드 호출; 당 한 번만 조정 됩니다. 나중에 열의 내용을 변경, 열은 자동으로 조정 합니다.The column width is adjusted only once per method call; if the contents of the column later change, the column will not automatically adjust. 모든 열의 크기를 조정 하려면 AutoResizeColumns 메서드를 사용 합니다.To resize all columns, use the AutoResizeColumns method. 내용이 변경 될 때마다 자동으로 크기가 조정 되도록 열을 설정 하려면 AutoSizeColumnsMode 속성 또는 열 AutoSizeMode 속성을 사용 합니다.To set the column to automatically resize whenever its contents change, use the AutoSizeColumnsMode property or the column AutoSizeMode property.

프로그래밍 방식으로 크기를 조정 하는 방법에 대 한 자세한 내용은 Windows Forms DataGridView 컨트롤의 크기 조정 옵션을 참조 하세요.For more information about programmatic resizing, see Sizing Options in the Windows Forms DataGridView Control.

추가 정보

AutoResizeColumn(Int32, DataGridViewAutoSizeColumnMode)

지정된 크기 모드를 사용하여 지정된 열의 너비를 조정합니다.Adjusts the width of the specified column using the specified size mode.

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

크기를 조정할 열의 인덱스입니다.The index of the column to resize.

autoSizeColumnMode
DataGridViewAutoSizeColumnMode

DataGridViewAutoSizeColumnMode 값 중 하나입니다.One of the DataGridViewAutoSizeColumnMode values.

예외

autoSizeColumnMode는 값이 ColumnHeader이며 ColumnHeadersVisiblefalse입니다.autoSizeColumnMode has the value ColumnHeader and ColumnHeadersVisible is false.

autoSizeColumnMode는 값이 NotSet, None 또는 Fill입니다.autoSizeColumnMode has the value NotSet, None, or Fill.

columnIndex가 0부터 열 수-1 사이에 속하지 않습니다.columnIndex is not in the valid range of 0 to the number of columns minus 1.

autoSizeColumnMode이 유효한 DataGridViewAutoSizeColumnMode 값이 아닙니다.autoSizeColumnMode is not a valid DataGridViewAutoSizeColumnMode value.

예제

다음 코드 예제에서는이 메서드를 사용 하 여 새 셀 값에 맞게 충분히 큰 열 너비를 확인 합니다.The following code example uses this method to make the column width large enough to accommodate a new cell value. 이 예제는 방법: DataGridView 컨트롤 Windows Forms에서 행 조작에서 사용할 수 있는 더 큰 예제의 일부입니다.This example is part of a larger example available in How to: Manipulate Rows in the Windows Forms DataGridView Control.

// 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

설명

이 메서드는 열 크기를 조정 하는 시기를 제어 하려는 경우에 유용 합니다.This method is useful if you want to control when a column resizes. 열 너비를 메서드 호출; 당 한 번만 조정 됩니다. 나중에 열의 내용을 변경, 열은 자동으로 조정 합니다.The column width is adjusted only once per method call; if the contents of the column later change, the column will not automatically adjust. 모든 열의 크기를 조정 하려면 AutoResizeColumns 메서드를 사용 합니다.To resize all columns, use the AutoResizeColumns method. 내용이 변경 될 때마다 자동으로 크기가 조정 되도록 열을 설정 하려면 AutoSizeColumnsMode 속성 또는 열 AutoSizeMode 속성을 사용 합니다.To set the column to automatically resize whenever its contents change, use the AutoSizeColumnsMode property or the column AutoSizeMode property.

이 오버 로드를 사용 하면 표시 된 행에 있는 셀의 제한 된 집합에서 값을 기반으로 새 너비를 계산 하는 크기 조정 모드를 지정할 수 있습니다.This overload lets you specify a sizing mode that calculates the new width based on values in a limited set of cells, such as those in displayed rows only. 이 컨트롤을 많은 수의 행을 포함 하는 경우 성능이 향상 됩니다.This improves performance when the control contains a large number of rows.

프로그래밍 방식으로 크기를 조정 하는 방법에 대 한 자세한 내용은 Windows Forms DataGridView 컨트롤의 크기 조정 옵션을 참조 하세요.For more information about programmatic resizing, see Sizing Options in the Windows Forms DataGridView Control.

추가 정보

AutoResizeColumn(Int32, DataGridViewAutoSizeColumnMode, Boolean)

지정된 크기 모드를 사용하고 필요한 경우 행 높이가 조정될 것이란 가정하에 너비를 계산하여 지정된 열의 너비를 조정합니다.Adjusts the width of the specified column using the specified size mode, optionally calculating the width with the expectation that row heights will subsequently be adjusted.

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

크기를 조정할 열의 인덱스입니다.The index of the column to resize.

autoSizeColumnMode
DataGridViewAutoSizeColumnMode

DataGridViewAutoSizeColumnMode 값 중 하나입니다.One of the DataGridViewAutoSizeColumnMode values.

fixedHeight
Boolean

현재 행 높이를 기준으로 새 너비를 계산하려면 true이고, 행 높이도 조정될 것이란 가정하에 너비를 계산하려면 false입니다.true to calculate the new width based on the current row heights; false to calculate the width with the expectation that the row heights will also be adjusted.

예외

autoSizeColumnMode는 값이 ColumnHeader이며 ColumnHeadersVisiblefalse입니다.autoSizeColumnMode has the value ColumnHeader and ColumnHeadersVisible is false.

autoSizeColumnMode는 값이 NotSet, None 또는 Fill입니다.autoSizeColumnMode has the value NotSet, None, or Fill.

columnIndex가 0부터 열 수-1 사이에 속하지 않습니다.columnIndex is not in the valid range of 0 to the number of columns minus 1.

autoSizeColumnMode이 유효한 DataGridViewAutoSizeColumnMode 값이 아닙니다.autoSizeColumnMode is not a valid DataGridViewAutoSizeColumnMode value.

설명

이 메서드는 열 크기를 조정 하는 시기를 제어 하려는 경우에 유용 합니다.This method is useful if you want to control when a column resizes. 열 너비를 메서드 호출; 당 한 번만 조정 됩니다. 나중에 열의 내용을 변경, 열은 자동으로 조정 합니다.The column width is adjusted only once per method call; if the contents of the column later change, the column will not automatically adjust. 모든 열의 크기를 조정 하려면 AutoResizeColumns 메서드를 사용 합니다.To resize all columns, use the AutoResizeColumns method. 내용이 변경 될 때마다 자동으로 크기가 조정 되도록 열을 설정 하려면 AutoSizeColumnsMode 속성 또는 열 AutoSizeMode 속성을 사용 합니다.To set the column to automatically resize whenever its contents change, use the AutoSizeColumnsMode property or the column AutoSizeMode property.

이 오버 로드를 사용 하면 표시 된 행에 있는 셀의 제한 된 집합에서 값을 기반으로 새 너비를 계산 하는 크기 조정 모드를 지정할 수 있습니다.This overload lets you specify a sizing mode that calculates the new width based on values in a limited set of cells, such as those in displayed rows only. 이 컨트롤을 많은 수의 행을 포함 하는 경우 성능이 향상 됩니다.This improves performance when the control contains a large number of rows.

이 오버 로드는 보호 되며 파생 된 DataGridView 클래스에서 적합 한 셀 높이-너비 비율을 달성할 수 있도록 설계 되었습니다.This overload is protected and is designed to enable you to achieve ideal cell height-to-width ratios in a derived DataGridView class. fixedHeight false되는 경우에는 AutoResizeRow 또는 AutoResizeRows 메서드를 호출 하는 것으로 예상 하 여 열 너비가 계산 됩니다.If fixedHeight is false, the column width will be calculated with the expectation that you will call the AutoResizeRow or AutoResizeRows method next.

프로그래밍 방식으로 크기를 조정 하는 방법에 대 한 자세한 내용은 Windows Forms DataGridView 컨트롤의 크기 조정 옵션을 참조 하세요.For more information about programmatic resizing, see Sizing Options in the Windows Forms DataGridView Control.

추가 정보

적용 대상