DataGridView.CurrentCell Proprietà
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Ottiene o imposta la cella attualmente attiva.
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
Valore della proprietà
Oggetto DataGridViewCell che rappresenta la cella corrente oppure null
se non esiste una cella corrente. Il valore predefinito è la prima cella nella prima colonna oppure null
se non esiste alcuna cella nel controllo.
- Attributi
Eccezioni
Non è possibile impostare il valore di questa proprietà perché non è possibile eseguire il commit o l'annullamento delle modifiche apportate alla cella corrente.
-oppure-
La cella specificata durante l'impostazione di questa proprietà è in una riga o colonna nascosta.
La chiamata rientrante è consentita solo quando l'oggetto DataGridView è associato a un DataSource. La chiamata rientrante risulta da una modifica dei dati sottostanti.
La cella specificata durante l'impostazione di questa proprietà non è presente in DataGridView.
Esempio
Nell'esempio di codice seguente viene illustrato come assicurarsi che la cella corrente sia visibile dopo l'ordinamento impostando la FirstDisplayedCell proprietà sulla cella recuperata tramite la CurrentCell proprietà . Questo codice funziona solo con un controllo non associato DataGridView . Con un DataGridView controllo associato a un'origine dati esterna, la cella corrente non viene salvata automaticamente in modo permanente durante l'ordinamento.
Per eseguire questo esempio, incollare il codice seguente in un modulo contenente un DataGridView oggetto denominato dataGridView1
. In C# è anche necessario connettere l'evento Sorted al gestore eventi.
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
Commenti
Quando si imposta una cella come cella corrente, scorrerà nella visualizzazione se non è attualmente visualizzata. La cella corrente non può essere una cella di intestazione, una cella disabilitata o una cella in una riga o colonna nascosta.
È possibile impostare questa proprietà su null
per rimuovere temporaneamente il rettangolo di attivazione, ma quando il controllo riceve lo stato attivo e il valore di questa proprietà è null
, viene impostato automaticamente sul valore della FirstDisplayedCell proprietà.
Quando si modifica il valore di questa proprietà, l'evento SelectionChanged si verifica prima dell'evento CurrentCellChanged . Qualsiasi SelectionChanged gestore eventi che accede alla CurrentCell proprietà in questo momento otterrà il valore precedente.
Quando si associa a un'origine DataGridView dati esterna, questa proprietà viene reimpostata sul valore predefinito.