DataGridView.AutoResizeColumns Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Dostosowuje szerokość wszystkich kolumn, aby dopasować zawartość ich komórek.
Przeciążenia
AutoResizeColumns() |
Dostosowuje szerokość wszystkich kolumn, aby pasowała do zawartości wszystkich komórek, w tym komórek nagłówka. |
AutoResizeColumns(DataGridViewAutoSizeColumnsMode) |
Dostosowuje szerokość wszystkich kolumn przy użyciu określonego trybu rozmiaru. |
AutoResizeColumns(DataGridViewAutoSizeColumnsMode, Boolean) |
Dostosowuje szerokość wszystkich kolumn przy użyciu określonego trybu rozmiaru, opcjonalnie oblicza szerokość z oczekiwaniami, że wysokość wierszy zostanie później skorygowana. |
AutoResizeColumns()
Dostosowuje szerokość wszystkich kolumn, aby pasowała do zawartości wszystkich komórek, w tym komórek nagłówka.
public:
void AutoResizeColumns();
public void AutoResizeColumns ();
member this.AutoResizeColumns : unit -> unit
Public Sub AutoResizeColumns ()
Przykłady
Poniższy przykład kodu zmienia rozmiar wszystkich kolumn w celu dopasowania do zawartości kolumn i nagłówków kolumn. Ten przykład kodu jest częścią większego przykładu przedstawionego w temacie Instrukcje: Programowe zmienianie rozmiaru komórek na zawartość w kontrolce dataGridView Windows Forms.
void SizeAllColumns( Object^ /*sender*/, EventArgs^ /*e*/ )
{
dataGridView1->AutoResizeColumns( DataGridViewAutoSizeColumnsMode::AllCells );
}
private void SizeAllColumns(Object sender, EventArgs e)
{
dataGridView1.AutoResizeColumns(
DataGridViewAutoSizeColumnsMode.AllCells);
}
Private Sub SizeAllColumns(ByVal sender As Object, _
ByVal e As System.EventArgs) Handles Button6.Click
DataGridView1.AutoResizeColumns(DataGridViewAutoSizeColumnsMode.AllCells)
End Sub
Uwagi
Ta metoda jest przydatna, jeśli chcesz kontrolować, kiedy zmienia się rozmiar kolumn. Szerokość kolumny jest dostosowywana tylko raz na wywołanie metody; jeśli zawartość kolumn zostanie później zmieniona, kolumny nie będą automatycznie dostosowywane. Aby zmienić rozmiar określonej kolumny, użyj AutoResizeColumn metody . Aby ustawić kolumny tak, aby automatycznie zmieniały rozmiar każdej zmiany zawartości, użyj AutoSizeColumnsMode właściwości lub właściwości kolumny AutoSizeMode .
Aby uzyskać więcej informacji na temat zmiany rozmiaru programowego, zobacz Opcje określania rozmiaru w kontrolce dataGridView Windows Forms.
Zobacz też
Dotyczy
AutoResizeColumns(DataGridViewAutoSizeColumnsMode)
Dostosowuje szerokość wszystkich kolumn przy użyciu określonego trybu rozmiaru.
public:
void AutoResizeColumns(System::Windows::Forms::DataGridViewAutoSizeColumnsMode autoSizeColumnsMode);
public void AutoResizeColumns (System.Windows.Forms.DataGridViewAutoSizeColumnsMode autoSizeColumnsMode);
member this.AutoResizeColumns : System.Windows.Forms.DataGridViewAutoSizeColumnsMode -> unit
Public Sub AutoResizeColumns (autoSizeColumnsMode As DataGridViewAutoSizeColumnsMode)
Parametry
- autoSizeColumnsMode
- DataGridViewAutoSizeColumnsMode
Jedna z DataGridViewAutoSizeColumnsMode wartości.
Wyjątki
autoSizeColumnsMode
ma wartość i ColumnHeadersVisible ma false
wartość ColumnHeader .
autoSizeColumnsMode
jest nieprawidłową DataGridViewAutoSizeColumnsMode wartością.
Przykłady
Poniższy przykład kodu zmienia rozmiar wszystkich kolumn w celu dopasowania do zawartości kolumn i nagłówków kolumn. Ten przykład kodu jest częścią większego przykładu przedstawionego w temacie Instrukcje: Programowe zmienianie rozmiaru komórek na zawartość w kontrolce dataGridView Windows Forms.
void SizeAllColumns( Object^ /*sender*/, EventArgs^ /*e*/ )
{
dataGridView1->AutoResizeColumns( DataGridViewAutoSizeColumnsMode::AllCells );
}
private void SizeAllColumns(Object sender, EventArgs e)
{
dataGridView1.AutoResizeColumns(
DataGridViewAutoSizeColumnsMode.AllCells);
}
Private Sub SizeAllColumns(ByVal sender As Object, _
ByVal e As System.EventArgs) Handles Button6.Click
DataGridView1.AutoResizeColumns(DataGridViewAutoSizeColumnsMode.AllCells)
End Sub
Uwagi
Ta metoda jest przydatna, jeśli chcesz kontrolować, kiedy zmienia się rozmiar kolumn. Szerokość kolumny jest dostosowywana tylko raz na wywołanie metody; jeśli zawartość kolumn zostanie później zmieniona, kolumny nie będą automatycznie dostosowywane. Aby zmienić rozmiar określonej kolumny, użyj AutoResizeColumn metody . Aby ustawić kolumny tak, aby automatycznie zmieniały rozmiar każdej zmiany zawartości, użyj AutoSizeColumnsMode właściwości lub właściwości kolumny AutoSizeMode .
To przeciążenie umożliwia określenie trybu ustalania rozmiaru, który oblicza nowe szerokości na podstawie wartości w ograniczonym zestawie komórek, takich jak te w wyświetlanych wierszach. Zwiększa to wydajność, gdy kontrolka zawiera dużą liczbę wierszy.
Aby uzyskać więcej informacji na temat zmiany rozmiaru programowego, zobacz Opcje określania rozmiaru w kontrolce dataGridView Windows Forms.
Zobacz też
Dotyczy
AutoResizeColumns(DataGridViewAutoSizeColumnsMode, Boolean)
Dostosowuje szerokość wszystkich kolumn przy użyciu określonego trybu rozmiaru, opcjonalnie oblicza szerokość z oczekiwaniami, że wysokość wierszy zostanie później skorygowana.
protected:
void AutoResizeColumns(System::Windows::Forms::DataGridViewAutoSizeColumnsMode autoSizeColumnsMode, bool fixedHeight);
protected void AutoResizeColumns (System.Windows.Forms.DataGridViewAutoSizeColumnsMode autoSizeColumnsMode, bool fixedHeight);
member this.AutoResizeColumns : System.Windows.Forms.DataGridViewAutoSizeColumnsMode * bool -> unit
Protected Sub AutoResizeColumns (autoSizeColumnsMode As DataGridViewAutoSizeColumnsMode, fixedHeight As Boolean)
Parametry
- autoSizeColumnsMode
- DataGridViewAutoSizeColumnsMode
Jedna z DataGridViewAutoSizeColumnsMode wartości.
- fixedHeight
- Boolean
true
aby obliczyć nowe szerokości na podstawie bieżących wysokości wierszy; false
aby obliczyć szerokość z oczekiwaniami, że wysokość wiersza również zostanie skorygowana.
Wyjątki
autoSizeColumnsMode
ma wartość i ColumnHeadersVisible ma false
wartość ColumnHeader .
autoSizeColumnsMode
jest nieprawidłową DataGridViewAutoSizeColumnsMode wartością.
Uwagi
Ta metoda jest przydatna, jeśli chcesz kontrolować, kiedy zmienia się rozmiar kolumn. Szerokość kolumny jest dostosowywana tylko raz na wywołanie metody; jeśli zawartość kolumn zostanie później zmieniona, kolumny nie będą automatycznie dostosowywane. Aby zmienić rozmiar określonej kolumny, użyj AutoResizeColumn metody . Aby ustawić kolumny tak, aby automatycznie zmieniały rozmiar każdej zmiany zawartości, użyj AutoSizeColumnsMode właściwości lub właściwości kolumny AutoSizeMode .
To przeciążenie umożliwia określenie trybu ustalania rozmiaru, który oblicza nowe szerokości na podstawie wartości w ograniczonym zestawie komórek, takich jak te w wyświetlanych wierszach. Zwiększa to wydajność, gdy kontrolka zawiera dużą liczbę wierszy.
To przeciążenie jest chronione i ma na celu umożliwienie osiągnięcia idealnych współczynników wysokości do szerokości komórek w klasie pochodnej DataGridView . Jeśli fixedHeight
jest to false
, szerokość kolumn zostanie obliczona z oczekiwaniami, że wywołasz metodę AutoResizeRow or AutoResizeRows dalej.
Aby uzyskać więcej informacji na temat zmiany rozmiaru programowego, zobacz Opcje określania rozmiaru w kontrolce dataGridView Windows Forms.