DataGridView.CurrentCell Vlastnost

  • Reference

Definice

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

Získá nebo nastaví aktuálně aktivní buňku.

public:
 property System::Windows::Forms::DataGridViewCell ^ CurrentCell { System::Windows::Forms::DataGridViewCell ^ get(); void set(System::Windows::Forms::DataGridViewCell ^ value); };
[System.ComponentModel.Browsable(false)]
public System.Windows.Forms.DataGridViewCell CurrentCell { get; set; }
[System.ComponentModel.Browsable(false)]
public System.Windows.Forms.DataGridViewCell? CurrentCell { get; set; }
[<System.ComponentModel.Browsable(false)>]
member this.CurrentCell : System.Windows.Forms.DataGridViewCell with get, set
Public Property CurrentCell As DataGridViewCell

Hodnota vlastnosti

DataGridViewCell

Hodnota DataGridViewCell , která představuje aktuální buňku, nebo null pokud neexistuje žádná aktuální buňka. Výchozí hodnota je první buňka v prvním sloupci nebo null pokud ovládací prvek neobsahuje žádné buňky.

Atributy
BrowsableAttribute

Výjimky

InvalidOperationException

Hodnotu této vlastnosti nelze nastavit, protože změny aktuální buňky nelze potvrdit ani zrušit.

-nebo-

Zadaná buňka při nastavení této vlastnosti je ve skrytém řádku nebo sloupci.

Volání do dalšího účastníka je povoleno pouze v případech, kdy DataGridView je vázán na DataSource. Volání opětovného účastníka je výsledkem změny podkladových dat.

ArgumentException

Zadaná buňka při nastavení této vlastnosti není v objektu DataGridView.

Příklady

Následující příklad kódu ukazuje, jak zajistit, aby aktuální buňka byla viditelná po řazení nastavením FirstDisplayedCell vlastnosti na buňku načtenou prostřednictvím CurrentCell vlastnosti . Tento kód funguje pouze s nevázaným DataGridView ovládacím prvku. Pokud je DataGridView ovládací prvek vázaný na externí zdroj dat, aktuální buňka se při řazení automaticky neuchová.

Chcete-li spustit tento příklad, vložte následující kód do formuláře, který obsahuje DataGridView s názvem dataGridView1. V jazyce C# je také nutné připojit Sorted událost k obslužné rutině události.

private void dataGridView1_Sorted(object sender, EventArgs e)
{
    this.dataGridView1.FirstDisplayedCell = this.dataGridView1.CurrentCell;
}

Private Sub dataGridView1_Sorted(ByVal sender As Object, _
    ByVal e As System.EventArgs) Handles dataGridView1.Sorted

    Me.dataGridView1.FirstDisplayedCell = Me.dataGridView1.CurrentCell

End Sub

Poznámky

Když nastavíte buňku jako aktuální buňku, posune se do zobrazení, pokud není aktuálně zobrazená. Aktuální buňka nemůže být buňka záhlaví, zakázaná buňka ani buňka ve skrytém řádku nebo sloupci.

Tuto vlastnost můžete nastavit na null , abyste dočasně odebrali obdélník fokusu, ale když ovládací prvek obdrží fokus a hodnota této vlastnosti je null, automaticky se nastaví na hodnotu FirstDisplayedCell vlastnosti .

Když změníte hodnotu této vlastnosti, SelectionChanged událost nastane před událostí CurrentCellChanged . Každá SelectionChanged obslužná rutina události, která v tuto chvíli přistupuje k CurrentCell vlastnosti, získá předchozí hodnotu.

Při vytvoření vazby DataGridView s externím zdrojem dat je tato vlastnost obnovena na výchozí hodnotu.

Platí pro

Viz také