DataGridViewColumn.AutoSizeMode Właściwość
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.
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 Wartość określająca, czy kolumna automatycznie dostosuje jej szerokość i jak określi preferowaną szerokość. Wartość domyślna to NotSet.
Wyjątki
Określona wartość podczas ustawiania tej właściwości jest nieprawidłowa DataGridViewAutoSizeColumnMode .
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ż
Opinia
https://aka.ms/ContentUserFeedback.
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź:Prześlij i wyświetl opinię dla