DataGridViewAutoSizeColumnsMode Wyliczenie
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.
Definiuje wartości służące do określania sposobu dostosowania szerokości kolumn.
public enum class DataGridViewAutoSizeColumnsMode
public enum DataGridViewAutoSizeColumnsMode
type DataGridViewAutoSizeColumnsMode =
Public Enum DataGridViewAutoSizeColumnsMode
- Dziedziczenie
Pola
AllCells | 6 | Szerokość kolumny jest dopasowywana do zawartości wszystkich komórek w kolumnach, w tym komórek nagłówka. |
AllCellsExceptHeader | 4 | Szerokość kolumny jest dopasowywana do zawartości wszystkich komórek w kolumnach, z wyłączeniem komórek nagłówka. |
ColumnHeader | 2 | Szerokość kolumny jest dopasowywana do zawartości komórek nagłówka kolumny. |
DisplayedCells | 10 | Szerokość kolumny jest dopasowywana do zawartości wszystkich komórek w kolumnach, które znajdują się w wierszach wyświetlanych obecnie na ekranie, w tym komórek nagłówka. |
DisplayedCellsExceptHeader | 8 | Szerokość kolumny jest dopasowywana do zawartości wszystkich komórek w kolumnach, które znajdują się w wierszach wyświetlanych obecnie na ekranie, z wyłączeniem komórek nagłówka. |
Fill | 16 | Szerokość kolumny dostosowuje się tak, aby szerokość wszystkich kolumn dokładnie wypełniała obszar wyświetlania kontrolki, wymagając przewijania poziomego tylko w celu zachowania szerokości kolumn powyżej MinimumWidth wartości właściwości. Względne szerokości kolumn są określane przez względne FillWeight wartości właściwości. |
None | 1 | Szerokości kolumn nie dopasowują się automatycznie. |
Przykłady
Poniższy przykład kodu ilustruje użycie tego wyliczenia w scenariuszu wzorca/szczegółów, w którym dwie DataGridView kontrolki wyświetlają dane z dwóch tabel w relacji nadrzędny/podrzędny. W tym przykładzie tryb określania rozmiaru kolumny dla kontrolki głównej to Brak, a szerokość kolumny jest inicjowana programowo w celu dopasowania do załadowanych wartości. Kontrolka szczegółów jest ustawiana na tryb automatycznego określania rozmiaru, dzięki czemu kolumny będą automatycznie dostosowywane za każdym razem, gdy wartości zmienią się (na przykład gdy użytkownik zmieni bieżący wiersz w tabeli nadrzędnej). Ten przykład jest częścią większego przykładu dostępnego w temacie How to: Create a Master/Detail Form Using Two Windows Forms DataGridView Controls (Jak utworzyć formularz główny/szczegółowy przy użyciu dwóch Windows Forms kontrolek DataGridView).
private void Form1_Load(object sender, System.EventArgs e)
{
// Bind the DataGridView controls to the BindingSource
// components and load the data from the database.
masterDataGridView.DataSource = masterBindingSource;
detailsDataGridView.DataSource = detailsBindingSource;
GetData();
// Resize the master DataGridView columns to fit the newly loaded data.
masterDataGridView.AutoResizeColumns();
// Configure the details DataGridView so that its columns automatically
// adjust their widths when the data changes.
detailsDataGridView.AutoSizeColumnsMode =
DataGridViewAutoSizeColumnsMode.AllCells;
}
Private Sub Form1_Load(ByVal sender As Object, ByVal e As System.EventArgs) _
Handles Me.Load
' Bind the DataGridView controls to the BindingSource
' components and load the data from the database.
masterDataGridView.DataSource = masterBindingSource
detailsDataGridView.DataSource = detailsBindingSource
GetData()
' Resize the master DataGridView columns to fit the newly loaded data.
masterDataGridView.AutoResizeColumns()
' Configure the details DataGridView so that its columns automatically
' adjust their widths when the data changes.
detailsDataGridView.AutoSizeColumnsMode = _
DataGridViewAutoSizeColumnsMode.AllCells
End Sub
Uwagi
Kontrolka DataGridView może zmienić rozmiar kolumn, aby wypełnić dostępną szerokość poziomą kontrolki lub wyświetlić pełną zawartość wszystkich komórek lub określonych komórek.
W Fill trybie preferowana szerokość kolumny jest określana przez zmianę rozmiaru wszystkich kolumn w tym trybie, tak aby wszystkie widoczne kolumny w kontrolce dokładnie wypełniały poziomą szerokość dostępnego obszaru wyświetlania. W przypadku innych trybów preferowana szerokość kolumny to minimalna szerokość wymagana do wyświetlenia największej wartości komórki ze wszystkich komórek lub podzbioru komórek w tej kolumnie, takich jak podzbiór komórek, które znajdują się w aktualnie wyświetlanych wierszach. Użycie podzestawu komórek do określenia nowej szerokości jest przydatne, aby uniknąć kary wydajności podczas pracy z wieloma wierszami danych.
Automatyczna zmiana rozmiaru oparta na zawartości uniemożliwia użytkownikom dostosowywanie szerokości kolumn za pomocą myszy. Zmiana rozmiaru użytkownika jest jednak włączona w trybie wypełniania.
To wyliczenie jest używane przez właściwość i AutoResizeColumns metodę kontrolki.DataGridView AutoSizeColumnsMode
Aby uzyskać więcej informacji na temat trybów ustalania rozmiaru, zobacz Opcje określania rozmiaru w kontrolce DataGridView Windows Forms. Aby uzyskać więcej informacji na temat trybu wypełniania kolumn w szczególności, zobacz Tryb wypełniania kolumn w kontrolce DataGridView Windows Forms.