DataGridViewAutoSizeColumnsMode Wyliczenie

  • Odwołanie

Definicja

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

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
Object
ValueType
Enum
DataGridViewAutoSizeColumnsMode

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.

Dotyczy

Zobacz też