DataGridView.CurrentCell Właściwość

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Windows.Forms
Zestaw:
System.Windows.Forms.dll

Pobiera lub ustawia aktualnie aktywną komórkę.

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

Wartość właściwości

DataGridViewCell

Reprezentuje DataGridViewCell bieżącą komórkę lub null , jeśli nie ma bieżącej komórki. Wartość domyślna to pierwsza komórka w pierwszej kolumnie lub null jeśli w kontrolce nie ma komórek.

Atrybuty
BrowsableAttribute

Wyjątki

InvalidOperationException

Nie można ustawić wartości tej właściwości, ponieważ nie można zatwierdzać ani anulować zmian bieżącej komórki.

-lub-

Określona komórka podczas ustawiania tej właściwości znajduje się w ukrytym wierszu lub kolumnie.

Ponowne wywoływanie jest dozwolone tylko wtedy, gdy DataGridView element jest powiązany z elementem DataSource. Ponowne wywoływanie wywołań powoduje zmianę danych bazowych.

ArgumentException

Określona komórka podczas ustawiania tej właściwości nie znajduje się w obiekcie DataGridView.

Przykłady

Poniższy przykład kodu ilustruje, jak upewnić się, że bieżąca komórka jest widoczna po sortowaniu, ustawiając FirstDisplayedCell właściwość na komórkę pobraną za pośrednictwem CurrentCell właściwości . Ten kod działa tylko z niezwiązaną DataGridView kontrolką. Przy użyciu kontrolki DataGridView powiązanej z zewnętrznym źródłem danych bieżąca komórka nie jest automatycznie utrwalana podczas sortowania.

Aby uruchomić ten przykład, wklej następujący kod w formularzu zawierającym DataGridView nazwę dataGridView1. W języku C# należy również połączyć zdarzenie z Sorted procedurą obsługi zdarzeń.

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

Uwagi

Gdy ustawisz komórkę jako bieżącą komórkę, zostanie przewinięt do widoku, jeśli nie jest ona obecnie wyświetlana. Bieżąca komórka nie może być komórką nagłówka, wyłączoną komórką lub komórką w ukrytym wierszu lub kolumnie.

Tę właściwość można ustawić null tak, aby tymczasowo usunąć prostokąt fokusu, ale gdy kontrolka odbiera fokus, a wartość tej właściwości to null, jest ona automatycznie ustawiana na wartość FirstDisplayedCell właściwości.

Po zmianie wartości tej właściwości SelectionChanged zdarzenie występuje przed zdarzeniem CurrentCellChanged . Każda SelectionChanged procedura obsługi zdarzeń, która CurrentCell uzyskuje dostęp do właściwości w tej chwili, uzyska poprzednią wartość.

Po powiązaniu DataGridView elementu z zewnętrznym źródłem danych ta właściwość zostanie zresetowana do jej wartości domyślnej.

Dotyczy

Zobacz też