DataGridView.AutoResizeColumn 메서드
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
지정된 열의 너비를 셀의 내용에 맞게 조정합니다.
오버로드
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
크기를 조정할 열의 인덱스입니다.
예외
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 값 중 하나입니다.
예외
autoSizeColumnMode
는 값이 ColumnHeader이며 ColumnHeadersVisible은 false
입니다.
columnIndex
가 0부터 열 수-1 사이에 속하지 않습니다.
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
입니다.
예외
autoSizeColumnMode
는 값이 ColumnHeader이며 ColumnHeadersVisible은 false
입니다.
columnIndex
가 0부터 열 수-1 사이에 속하지 않습니다.
autoSizeColumnMode
는 유효한 DataGridViewAutoSizeColumnMode 값이 아닙니다.
설명
이 메서드는 열의 크기가 조정되는 시기를 제어하려는 경우에 유용합니다. 열 너비는 메서드 호출당 한 번만 조정됩니다. 나중에 열 내용이 변경되면 열이 자동으로 조정되지 않습니다. 모든 열의 크기를 조정하려면 메서드를 AutoResizeColumns 사용합니다. 열의 내용이 변경 될 때마다 자동으로 크기를 조정 하도록 설정 하려면 속성 또는 열 AutoSizeMode 속성을 사용 합니다AutoSizeColumnsMode.
이 오버로드를 사용하면 표시된 행에만 있는 셀과 같이 제한된 셀 집합의 값에 따라 새 너비를 계산하는 크기 조정 모드를 지정할 수 있습니다. 이렇게 하면 컨트롤에 많은 수의 행이 포함된 경우 성능이 향상됩니다.
이 오버로드는 보호되며 파생 DataGridView 클래스에서 이상적인 셀 높이 대 너비 비율을 달성할 수 있도록 설계되었습니다. 이 false
경우 fixedHeight
열 너비는 다음에 또는 AutoResizeRows 메서드를 호출 AutoResizeRow 할 것으로 예상하여 계산됩니다.
프로그래밍 방식 크기 조정에 대한 자세한 내용은 Windows Forms DataGridView 컨트롤의 크기 조정 옵션을 참조하세요.