DataGridView.AutoSizeColumnsMode Vlastnost

  • Reference

Definice

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

Získá nebo nastaví hodnotu určující, jak se určují šířky sloupců.

public:
 property System::Windows::Forms::DataGridViewAutoSizeColumnsMode AutoSizeColumnsMode { System::Windows::Forms::DataGridViewAutoSizeColumnsMode get(); void set(System::Windows::Forms::DataGridViewAutoSizeColumnsMode value); };
public System.Windows.Forms.DataGridViewAutoSizeColumnsMode AutoSizeColumnsMode { get; set; }
member this.AutoSizeColumnsMode : System.Windows.Forms.DataGridViewAutoSizeColumnsMode with get, set
Public Property AutoSizeColumnsMode As DataGridViewAutoSizeColumnsMode

Hodnota vlastnosti

DataGridViewAutoSizeColumnsMode

Hodnota DataGridViewAutoSizeColumnsMode . Výchozí formát je None.

Výjimky

InvalidEnumArgumentException

Zadaná hodnota při nastavení této vlastnosti není platná DataGridViewAutoSizeColumnsMode hodnota.

InvalidOperationException

Zadaná hodnota při nastavení této vlastnosti je ColumnHeader, záhlaví sloupců jsou skryté a alespoň jeden viditelný sloupec má AutoSizeMode hodnotu vlastnosti .NotSet

-nebo- Zadaná hodnota při nastavení této vlastnosti je Fill aspoň jeden viditelný sloupec s AutoSizeMode hodnotou NotSet vlastnosti je zmrazený.

Příklady

Následující příklad kódu ukazuje, jak tuto vlastnost použít ve scénáři předlohy/podrobností, kde dva DataGridView ovládací prvky zobrazují data ze dvou tabulek v relaci nadřazené/podřízené položky. V tomto příkladu je Nonerežim velikosti sloupce pro hlavní ovládací prvek a šířky sloupců jsou programově inicializovány tak, aby odpovídaly načteným hodnotám. Ovládací prvek podrobností je nastavený na režim automatického nastavení velikosti sloupců, aby se sloupce automaticky upravily 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í většího příkladu, který je k dispozici v části Postupy: Vytvoření hlavního a 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

Tato vlastnost umožňuje konfigurovat ovládací prvek tak, aby šířky sloupců byly automaticky upraveny tak, aby se ovládací prvek vyplnil nebo aby odpovídal obsahu buňky. Úpravy velikosti probíhají v režimu výplně, kdykoli se změní šířka ovládacího prvku. V režimech určení velikosti na základě obsahu dojde k úpravám velikosti pokaždé, když se změní obsah buňky nebo pokud WrapMode je povolená, kdykoli se změní výška řádku. Některé režimy velikosti založené na obsahu umožňují omezit úpravy velikosti na aktuálně zobrazené řádky, aby se zvýšil výkon.

Pokud chcete změnit režim velikosti pro jednotlivý sloupec, nastavte jeho AutoSizeMode vlastnost. Výchozí hodnota této vlastnosti znamená NotSet, že sloupec dědí jeho chování a jeho InheritedAutoSizeMode hodnotu vlastnosti z ovládacího prvku.

Sloupce v režimu výplně rozdělují dostupnou šířku ovládacího prvku v poměrech označených hodnotami jejich FillWeight vlastností. Šířka dostupná pro režim výplně je určena odečtením šířky všech ostatních sloupců z šířky klientské oblasti ovládacího prvku. Pokud je tato šířka menší než kombinované MinimumWidth hodnoty všech sloupců v režimu výplně, zobrazí se vodorovný posuvník, zobrazí se všechny sloupce režimu výplně s minimální šířkou a změna velikosti sloupců uživatele je zakázaná. Další informace o režimu výplně sloupce najdete v tématu Režim výplně sloupce v ovládacím prvku model Windows Forms DataGridView.

Automaticky se změní velikost pouze sloupců s Visible hodnotou true vlastnosti a změna viditelnosti sloupce nezpůsobí změnu velikosti. Kromě toho, když jsou sloupce nastaveny na automatickou změnu velikosti, uživatel nemůže upravit šířky sloupců myší.

Chcete-li upravit šířky sloupců programově, použijte AutoResizeColumn nebo metody nebo AutoResizeColumns nastavte vlastnost sloupce Width .

Další informace o automatickém nastavení velikosti založeném na obsahu najdete v tématu Možnosti velikosti v ovládacím prvku model Windows Forms DataGridView.

Platí pro

Viz také