DataGridViewColumn.AutoSizeMode Vlastnost

  • Reference

Definice

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

Získá nebo nastaví režim, podle kterého sloupec automaticky upraví jeho šířku.

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

Hodnota vlastnosti

DataGridViewAutoSizeColumnMode

Hodnota DataGridViewAutoSizeColumnMode , která určuje, jestli sloupec automaticky upraví šířku a jak určí upřednostňovanou šířku. Výchozí formát je NotSet.

Výjimky

InvalidEnumArgumentException

Zadaná hodnota při nastavení této vlastnosti je neplatná DataGridViewAutoSizeColumnMode .

InvalidOperationException

Zadaná hodnota při nastavení této vlastnosti vede k InheritedAutoSizeMode hodnotě viditelného ColumnHeader sloupce, když jsou záhlaví sloupců skrytá.

-nebo- Zadaná hodnota při nastavování této vlastnosti vede k InheritedAutoSizeMode hodnotě viditelného Fill sloupce, který je zablokovaný.

Příklady

Následující příklad kódu vynutí sloupec automaticky změnit jeho šířku tak, aby odpovídal jeho obsahu. Tento příklad kódu je součástí většího příkladu zadaného DataGridViewColumn pro třídu.

// AutoSize the third column.
void Button6_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
{
   DataGridViewColumn^ column = dataGridView->Columns[ 2 ];
   column->AutoSizeMode = DataGridViewAutoSizeColumnMode::DisplayedCells;
}

// AutoSize the third column.
private void Button6_Click(object sender,
    System.EventArgs e)
{
    DataGridViewColumn column = dataGridView.Columns[2];
    column.AutoSizeMode = DataGridViewAutoSizeColumnMode.DisplayedCells;
}

' AutoSize the third column.
Private Sub Button6_Click(ByVal sender As Object, _
    ByVal e As System.EventArgs) Handles Button6.Click

    Dim column As DataGridViewColumn = dataGridView.Columns(2)
    column.AutoSizeMode = DataGridViewAutoSizeColumnMode.DisplayedCells
End Sub

Poznámky

Chování automatického nastavení velikosti sloupce je určeno hodnotou InheritedAutoSizeMode vlastnosti, která je stejná jako hodnota AutoSizeMode vlastnosti pro všechny hodnoty s výjimkou NotSet, což znamená, že hodnota je zděděna z DataGridView.AutoSizeColumnsMode vlastnosti.

InheritedAutoSizeMode Pokud je Fillhodnota vlastnosti , sloupec se změní na velikost spolu s dalšími sloupci v daném režimu. Všechny sloupce v režimu výplně v ovládacím prvku rozdělují dostupné místo v poměrech urč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.

InheritedAutoSizeMode Pokud je vlastnost nastavena na libovolnou jinou hodnotu s výjimkou None, sloupec bude spravovat jeho šířku, aby se hodnoty buněk plně zobrazovaly bez výřezu. 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.

Visible Změna viditelnosti sloupce s hodnotou true vlastnosti se změní na velikost a změna viditelnosti sloupce nezpůsobuje 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 DataGridView ovládací prvek AutoResizeColumn nebo AutoResizeColumns metody nebo 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é