Sdílet prostřednictvím

DataGridViewAutoSizeColumnsMode Výčet

  • Reference

Definice

Obor názvů:
System.Windows.Forms
Sestavení:
System.Windows.Forms.dll

Definuje hodnoty pro určení způsobu úpravy šířky sloupců.

public enum class DataGridViewAutoSizeColumnsMode
public enum DataGridViewAutoSizeColumnsMode
type DataGridViewAutoSizeColumnsMode = 
Public Enum DataGridViewAutoSizeColumnsMode
Dědičnost
Object
ValueType
Enum
DataGridViewAutoSizeColumnsMode

Pole

AllCells 6

Šířky sloupců se přizpůsobí obsahu všech buněk ve sloupcích, včetně buněk záhlaví.
AllCellsExceptHeader 4

Šířky sloupců se přizpůsobí obsahu všech buněk ve sloupcích s výjimkou buněk záhlaví.
ColumnHeader 2

Šířky sloupců se přizpůsobí obsahu buněk záhlaví sloupce.
DisplayedCells 10

Šířky sloupců se přizpůsobí obsahu všech buněk ve sloupcích, které jsou aktuálně zobrazené na obrazovce, včetně buněk záhlaví.
DisplayedCellsExceptHeader 8

Šířky sloupců se přizpůsobí obsahu všech buněk ve sloupcích, které jsou aktuálně zobrazené na obrazovce, s výjimkou buněk záhlaví.
Fill 16

Šířky sloupců se upraví tak, aby šířky všech sloupců přesně zaplnily oblast zobrazení ovládacího prvku. Vodorovné posouvání vyžaduje pouze proto, aby šířky sloupců zůstaly nad MinimumWidth hodnotami vlastností. Relativní šířky sloupců jsou určeny hodnotami relativních FillWeight vlastností.
None 1

Šířky sloupců se automaticky neupravují.

Příklady

Následující příklad kódu ukazuje použití tohoto výčtu ve scénáři hlavní/podrobnosti, kde dva DataGridView ovládací prvky zobrazují data ze dvou tabulek v relaci nadřazený/podřízený. V tomto příkladu je režim nastavení velikosti sloupce pro hlavní ovládací prvek None a šířky sloupců jsou programově inicializovány tak, aby odpovídaly načteným hodnotám. Ovládací prvek podrobností je nastaven do režimu automatického nastavení velikosti, takže se sloupce automaticky upraví při každé změně hodnot (například když uživatel změní aktuální řádek v nadřazené tabulce). Tento příklad je součástí rozsáhlejšího příkladu, který je k dispozici v tématu Postupy: Vytvoření hlavního nebo podrobného formuláře pomocí dvou model Windows Forms ovládacích prvků 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

Poznámky

Ovládací DataGridView prvek může změnit velikost sloupců tak, aby vyplňovaly dostupnou vodorovnou šířku ovládacího prvku nebo aby zobrazovaly celý obsah všech buněk nebo zadaných buněk.

U Fill režimu se upřednostňovaná šířka sloupce určuje změnou velikosti všech sloupců v daném režimu tak, aby všechny viditelné sloupce v ovládacím prvku přesně zaplnily vodorovnou šířku dostupné oblasti zobrazení. U jiných režimů je upřednostňovanou šířkou sloupce minimální šířka potřebná k zobrazení největší hodnoty buňky ze všech buněk nebo podmnožina buněk v daném sloupci, například podmnožina buněk, které jsou v aktuálně zobrazených řádcích. Použití podmnožina buněk k určení nové šířky je užitečné, abyste se vyhnuli snížení výkonu při práci s mnoha řádky dat.

Automatická změna velikosti na základě obsahu brání uživatelům v úpravě šířky sloupců pomocí myši. Změna velikosti uživatele je však povolená v režimu vyplnění.

Tento výčet je používán vlastností a AutoResizeColumns metodou DataGridView ovládacího prvkuAutoSizeColumnsMode.

Další informace o režimech změny velikosti najdete v tématu Možnosti změny velikosti v ovládacím prvku model Windows Forms DataGridView. Další informace o režimu vyplňování sloupců naleznete v tématu Režim vyplnění sloupce v model Windows Forms DataGridView ovládací prvek.

Platí pro

Viz také