DataGridViewColumn.AutoSizeMode Właściwość

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Windows.Forms
Zestaw:
System.Windows.Forms.dll

Pobiera lub ustawia tryb automatycznego dostosowywania szerokości kolumny.

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

Wartość właściwości

DataGridViewAutoSizeColumnMode

DataGridViewAutoSizeColumnMode Wartość określająca, czy kolumna automatycznie dostosuje jej szerokość i jak określi preferowaną szerokość. Wartość domyślna to NotSet.

Wyjątki

InvalidEnumArgumentException

Określona wartość podczas ustawiania tej właściwości jest nieprawidłowa DataGridViewAutoSizeColumnMode .

InvalidOperationException

Określona wartość podczas ustawiania tej właściwości powoduje InheritedAutoSizeMode wyświetlenie wartości ColumnHeader dla widocznej kolumny, gdy nagłówki kolumn są ukryte.

-lub-

Określona wartość podczas ustawiania tej właściwości powoduje InheritedAutoSizeMode wartość Fill dla widocznej kolumny, która jest zamrożona.

Przykłady

Poniższy przykład kodu wymusza, aby kolumna automatycznie zmieniała jej szerokość, aby pasowała do jej zawartości. Ten przykład kodu jest częścią większego przykładu udostępnionego DataGridViewColumn dla klasy .

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

Uwagi

Zachowanie automatycznego określania rozmiaru kolumny jest określane przez wartość InheritedAutoSizeMode właściwości, która jest taka sama jak wartość AutoSizeMode właściwości dla wszystkich wartości z wyjątkiem NotSet, co wskazuje, że wartość jest dziedziczona z DataGridView.AutoSizeColumnsMode właściwości.

InheritedAutoSizeMode Gdy wartość właściwości to Fill, rozmiar kolumny jest zmieniany wraz z innymi kolumnami w tym trybie. Wszystkie kolumny w trybie wypełnienia w kontrolce dzielą dostępne miejsce w proporcjach określonych przez ich FillWeight wartości właściwości. Szerokość dostępna dla trybu wypełnienia jest określana przez odjęcie szerokości wszystkich pozostałych kolumn od szerokości obszaru klienta kontrolki. Jeśli ta szerokość jest mniejsza niż łączne MinimumWidth wartości wszystkich kolumn w trybie wypełniania, zostanie wyświetlony poziomy pasek przewijania, wszystkie kolumny w trybie wypełniania są wyświetlane z minimalnymi szerokościami, a zmiana rozmiaru kolumny użytkownika jest wyłączona. Aby uzyskać więcej informacji na temat trybu wypełniania kolumny, zobacz Tryb wypełniania kolumny w kontrolce DataGridView Windows Forms.

Gdy właściwość jest ustawiona InheritedAutoSizeMode na dowolną inną wartość z wyjątkiem None, kolumna będzie zarządzać jej szerokością, tak aby jej wartości komórek były w pełni wyświetlane bez przycinania. W trybach określania rozmiaru na podstawie zawartości zmiany rozmiaru są zmieniane za każdym razem, gdy zawartość komórki zmienia się lub, jeśli WrapMode jest włączona, za każdym razem, gdy zmienia się wysokość wiersza. Niektóre tryby ustalania rozmiaru oparte na zawartości umożliwiają ograniczenie rozmiaru do aktualnie wyświetlanych wierszy w celu zwiększenia wydajności.

Zmiana rozmiaru true tylko kolumn z wartością Visible właściwości jest zmieniana, a zmiana widoczności kolumny nie powoduje zmiany rozmiaru. Ponadto po ustawieniu automatycznego zmieniania rozmiaru kolumn użytkownik nie może dostosować szerokości kolumn za pomocą myszy.

Aby programowo dostosować szerokość kolumny, użyj metod lub AutoResizeColumns metod kontrolki AutoResizeColumn albo ustaw właściwość kolumnyWidth.DataGridView

Aby uzyskać więcej informacji na temat automatycznego określania rozmiaru opartego na zawartości, zobacz Opcje określania rozmiaru w kontrolce DataGridView Windows Forms.

Dotyczy

Zobacz też