DataGridView.FirstDisplayedCell Właściwość

Definicja

Przestrzeń nazw:

System.Windows.Forms

Zestaw:

System.Windows.Forms.dll

Pobiera lub ustawia pierwszą komórkę wyświetlaną DataGridViewobecnie w obiekcie ; zazwyczaj ta komórka znajduje się w lewym górnym rogu.

public:
 property System::Windows::Forms::DataGridViewCell ^ FirstDisplayedCell { System::Windows::Forms::DataGridViewCell ^ get(); void set(System::Windows::Forms::DataGridViewCell ^ value); };

[System.ComponentModel.Browsable(false)]
public System.Windows.Forms.DataGridViewCell FirstDisplayedCell { get; set; }

[<System.ComponentModel.Browsable(false)>]
member this.FirstDisplayedCell : System.Windows.Forms.DataGridViewCell with get, set

Public Property FirstDisplayedCell As DataGridViewCell

Wartość właściwości

DataGridViewCell

Pierwszy DataGridViewCell aktualnie wyświetlany w kontrolce.

Atrybuty

BrowsableAttribute

Wyjątki

ArgumentException

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

InvalidOperationException

Określona komórka podczas ustawiania tej właściwości ma RowIndex wartość właściwości lub ColumnIndex -1 wskazującą, że jest to komórka nagłówka lub współdzielona komórka.

-lub-

Określona komórka podczas ustawiania tej właściwości ma Visible wartość falsewłaściwości .

Przykłady

Poniższy przykład kodu ilustruje, jak upewnić się, że bieżąca komórka jest widoczna po sortowaniu. 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

Za pomocą tej właściwości można określić, która komórka znajduje się w pierwszym wierszu i kolumnie aktualnie wyświetlanej w kontrolce. Zazwyczaj znajduje się to w lewym górnym rogu, ale w przypadku języków od prawej do lewej znajduje się w prawym górnym rogu. Możesz również ustawić tę właściwość, aby przewijać kontrolkę do wskazanej komórki.

Zobacz też

• CurrentCell
• DataGridView — Formant (Formularze systemu Windows)