DataGridView.CurrentCell Vlastnost
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
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
Představuje DataGridViewCell 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 v ovládacím prvku nejsou žádné buňky.
- Atributy
Výjimky
Hodnotu této vlastnosti nelze nastavit, protože změny aktuální buňky nelze potvrdit nebo zrušit.
nebo
Zadaná buňka při nastavení této vlastnosti je ve skrytém řádku nebo sloupci.
Opětovné volání účastníků je povoleno pouze v případech, kdy je vázán DataSourcena DataGridView . Volajícím se znovu zobrazí výsledky změny podkladových dat.
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 jenom s nevázaným DataGridView ovládacím prvku. Když je DataGridView ovládací prvek svázaný s externím zdrojem 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 pojmenovaný DataGridViewdataGridView1. V jazyce C# musíte také 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 se aktuálně nezobrazuje. 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 tak, aby null dočasně odebral obdélník fokusu, ale když ovládací prvek přijme fokus a hodnota této vlastnosti je null, automaticky se nastaví na hodnotu FirstDisplayedCell vlastnosti.
Když změníte hodnotu této vlastnosti, SelectionChanged nastane událost před CurrentCellChanged událostí. Jakákoli SelectionChanged obslužná rutina události, která CurrentCell v tuto chvíli přistupuje k vlastnosti, získá předchozí hodnotu.
Při vytvoření vazby DataGridView k externímu zdroji dat se tato vlastnost resetuje na výchozí hodnotu.