DataGridViewAutoSizeColumnsMode Wyliczenie

Definicja

Definiuje wartości określające sposób dopasowywania szerokości kolumn.Defines values for specifying how the widths of columns are adjusted.

public enum class DataGridViewAutoSizeColumnsMode
public enum DataGridViewAutoSizeColumnsMode
type DataGridViewAutoSizeColumnsMode = 
Public Enum DataGridViewAutoSizeColumnsMode
Dziedziczenie
DataGridViewAutoSizeColumnsMode

Pola

AllCells 6

Szerokości kolumn dostosowują się do dopasowania do zawartości wszystkich komórek w kolumnach, w tym komórek nagłówka.The column widths adjust to fit the contents of all cells in the columns, including header cells.

AllCellsExceptHeader 4

Szerokości kolumn dostosowują się do dopasowania do zawartości wszystkich komórek w kolumnach, z wyłączeniem komórek nagłówka.The column widths adjust to fit the contents of all cells in the columns, excluding header cells.

ColumnHeader 2

Szerokości kolumn dopasowuje się do zawartości komórek nagłówka kolumny.The column widths adjust to fit the contents of the column header cells.

DisplayedCells 10

Szerokości kolumn dostosowują się do rozmiaru wszystkich komórek w kolumnach, które znajdują się w wierszach wyświetlanych aktualnie na ekranie, w tym komórki nagłówka.The column widths adjust to fit the contents of all cells in the columns that are in rows currently displayed onscreen, including header cells.

DisplayedCellsExceptHeader 8

Szerokości kolumn dostosowują się do dopasowania do zawartości wszystkich komórek w kolumnach, które znajdują się w wierszach wyświetlanych aktualnie na ekranie, z wyłączeniem komórek nagłówka.The column widths adjust to fit the contents of all cells in the columns that are in rows currently displayed onscreen, excluding header cells.

Fill 16

Szerokości kolumn dostosowują się tak, aby szerokość wszystkich kolumn była dokładnie wypełniana obszarem wyświetlania kontrolki, wymagając przewijania w poziomie tylko, aby zachować szerokość kolumn powyżej MinimumWidth wartości właściwości.The column widths adjust so that the widths of all columns exactly fill the display area of the control, requiring horizontal scrolling only to keep column widths above the MinimumWidth property values. Względne szerokości kolumn są określane przez FillWeight wartości właściwości względnych.Relative column widths are determined by the relative FillWeight property values.

None 1

Szerokości kolumn nie są dostosowywane automatycznie.The column widths do not automatically adjust.

Przykłady

Poniższy przykład kodu ilustruje użycie tego wyliczenia w scenariuszu wzorzec/szczegóły, w którym dwie DataGridView kontrolki wyświetlają dane z dwóch tabel w relacji nadrzędny/podrzędny.The following code example illustrates the use of this enumeration in a master/details scenario where two DataGridView controls display data from two tables in a parent/child relationship. W tym przykładzie tryb ustalania rozmiaru kolumny dla formantu głównego to None, a szerokości kolumn są programowo inicjowane w celu dopasowania do załadowanych wartości.In this example, the column sizing mode for the master control is None and the column widths are programmatically initialized to fit the loaded values. Kontrolka szczegółów jest ustawiana na tryb automatycznej zmiany, tak aby kolumny były dostosowywane automatycznie przy każdej zmianie wartości (na przykład gdy użytkownik zmieni bieżący wiersz w tabeli nadrzędnej).The details control is set to an automatic sizing mode so that columns will adjust automatically whenever the values change (for example, when the user changes the current row in the parent table). Ten przykład jest częścią większego przykładu dostępnego w instrukcje: Tworzenie formularza wzorzec/szczegół za pomocą dwóch Windows Forms formantów DataGridView.This example is part of a larger example available in How to: Create a Master/Detail Form Using Two Windows Forms DataGridView Controls.

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

DataGridViewFormant może zmienić rozmiar kolumn, aby wypełnić dostępną w poziomie szerokość formantu lub wyświetlić całą zawartość wszystkich komórek lub określonych komórek.The DataGridView control can resize its columns to make them fill the available horizontal width of the control or to make them display the full contents of all cells or of specified cells.

W Fill trybie z trybem Preferowana szerokość kolumny jest określana przez zmianę rozmiarów wszystkich kolumn w tym trybie, tak aby wszystkie widoczne kolumny w formancie dokładnie wypełniają poziomą szerokość dostępnego obszaru wyświetlania.With Fill mode, the preferred width of a column is determined by resizing all columns in that mode so that all visible columns in the control exactly fill the horizontal width of the available display area. W przypadku innych trybów Preferowana szerokość kolumny jest minimalnej szerokości wymaganej do wyświetlenia największej wartości komórki ze wszystkich komórek lub podzbioru komórek w tej kolumnie, takich jak podzestaw komórek znajdujących się w aktualnie wyświetlanych wierszach.With other modes, the preferred column width is the minimum width required to display the largest cell value from all cells or a subset of cells in that column, such as the subset of cells that are in currently displayed rows. Użycie podzbioru komórek do określenia nowej szerokości jest przydatne, aby uniknąć spadek wydajności podczas pracy z wieloma wierszami danych.Using a subset of cells to determine the new width is useful to avoid a performance penalty when working with many rows of data.

Automatyczna zmiana rozmiarów oparta na zawartości uniemożliwia użytkownikom dostosowywanie szerokości kolumn za pomocą myszy.Content-based automatic resizing prevents users from adjusting column widths with the mouse. Zmienianie rozmiarów użytkownika jest włączone w trybie wypełniania.User resizing is enabled in fill mode, however.

To wyliczenie jest używane przez DataGridView AutoSizeColumnsMode Właściwość i metodę kontrolki AutoResizeColumns .This enumeration is used by the DataGridView control AutoSizeColumnsMode property and AutoResizeColumns method.

Aby uzyskać więcej informacji na temat trybów ustalania rozmiarów, zobacz Opcje ustalania rozmiarów w kontrolce DataGridView Windows Forms.For more information about sizing modes, see Sizing Options in the Windows Forms DataGridView Control. 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.For more information about column fill mode in particular, see Column Fill Mode in the Windows Forms DataGridView Control.

Dotyczy

Zobacz też