DataGridView.CurrentCell Właściwość

Definicja

Pobiera lub ustawia aktualnie aktywną komórkę.Gets or sets the currently active cell.

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)>]
member this.CurrentCell : System.Windows.Forms.DataGridViewCell with get, set
Public Property CurrentCell As DataGridViewCell

Wartość właściwości

DataGridViewCell

DataGridViewCellReprezentuje bieżącą komórkę lub null nie ma bieżącej komórki.The DataGridViewCell that represents the current cell, or null if there is no current cell. Wartość domyślna to pierwsza komórka w pierwszej kolumnie lub null Jeśli w kontrolce nie ma komórek.The default is the first cell in the first column or null if there are no cells in the control.

Atrybuty

Wyjątki

Nie można ustawić wartości tej właściwości, ponieważ nie można zatwierdzić ani anulować zmian w bieżącej komórce.The value of this property cannot be set because changes to the current cell cannot be committed or canceled.

-lub--or- Określona komórka podczas ustawiania tej właściwości znajduje się w ukrytym wierszu lub kolumnie.The specified cell when setting this property is in a hidden row or column.

Wywołanie w celu ponownego współdziałania jest dozwolone tylko wtedy, gdy DataGridView jest powiązane z DataSource .Re-entrant calling is only allowed when the DataGridView is bound to a DataSource. Ponowne nawiązywanie połączenia z wynikami zmiany danych źródłowych.Re-entrant calling results from a change to the underlying data.

Określona komórka, gdy ustawienie tej właściwości nie znajduje się w DataGridView .The specified cell when setting this property is not in the DataGridView.

Przykłady

Poniższy przykład kodu ilustruje, jak upewnić się, że bieżąca komórka jest widoczna po sortowaniu przez ustawienie FirstDisplayedCell właściwości do komórki pobranej za pomocą CurrentCell właściwości.The following code example illustrates how to ensure that the current cell is visible after sorting by setting the FirstDisplayedCell property to the cell retrieved through the CurrentCell property. Ten kod działa tylko z niepowiązaną DataGridView kontrolką.This code works only with an unbound DataGridView control. DataGridViewPo powiązaniu formantu z zewnętrznym źródłem danych bieżąca komórka nie jest automatycznie utrwalana podczas sortowania.With a DataGridView control bound to an external data source, the current cell is not automatically persisted when sorting.

Aby uruchomić ten przykład, wklej następujący kod do formularza, który zawiera DataGridView nazwę dataGridView1 .To run this example, paste the following code into a form that contains a DataGridView named dataGridView1. W języku C# należy również połączyć Sorted zdarzenie z obsługą zdarzeń.In C#, you must also connect the Sorted event to the event handler.

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 ona przewinięty do widoku, jeśli nie jest aktualnie wyświetlana.When you set a cell as the current cell, it will scroll into view if it is not currently displayed. Bieżąca komórka nie może być komórką nagłówka, komórką wyłączoną ani komórką w ukrytym wierszu lub kolumnie.The current cell cannot be a header cell, a disabled cell, or a cell in a hidden row or column.

Możesz ustawić tę właściwość na null , aby tymczasowo usunąć prostokąt fokusu, ale gdy kontrolka odbierze fokus i wartość tej właściwości jest null , jest automatycznie ustawiana na wartość FirstDisplayedCell właściwości.You can set this property to null to temporarily remove the focus rectangle, but when the control receives focus and the value of this property is null, it is automatically set to the value of the FirstDisplayedCell property.

Zmiana wartości tej właściwości spowoduje SelectionChanged wystąpienie zdarzenia przed CurrentCellChanged zdarzeniem.When you change the value of this property, the SelectionChanged event occurs before the CurrentCellChanged event. Każdy SelectionChanged program obsługi zdarzeń uzyskujący dostęp do CurrentCell właściwości w tym momencie uzyska poprzednią wartość.Any SelectionChanged event handler accessing the CurrentCell property at this time will get its previous value.

Po utworzeniu powiązania z DataGridView zewnętrznym źródłem danych ta właściwość jest resetowana do wartości domyślnej.When you bind the DataGridView to an external data source, this property is reset to its default value.

Dotyczy

Zobacz też