DataGridView.FirstDisplayedCell Eigenschaft

Definition

Ruft die erste derzeit in der DataGridView angezeigte Zelle ab oder legt diese fest. In der Regel befindet sich diese Zelle in der linken oberen Ecke.

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

Eigenschaftswert

Die erste derzeit im Steuerelement angezeigte DataGridViewCell.

Attribute

Ausnahmen

Die beim Festlegen dieser Eigenschaft angegebene Zelle befindet sich nicht in der DataGridView.

Die beim Festlegen dieser Eigenschaft angegebene Zelle weist den Wert -1 für die RowIndex- oder ColumnIndex-Eigenschaft auf, was darauf hinweist, dass es sich um eine Headerzelle oder eine freigegebene Zelle handelt.

- oder -

Die beim Festlegen dieser Eigenschaft angegebene Zelle weist den Visible-Eigenschaftswert false auf.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Sie sicherstellen, dass die aktuelle Zelle nach dem Sortieren sichtbar ist. Dieser Code funktioniert nur mit einem ungebundenen DataGridView Steuerelement. Wenn ein DataGridView Steuerelement an eine externe Datenquelle gebunden ist, wird die aktuelle Zelle beim Sortieren nicht automatisch beibehalten.

Fügen Sie zum Ausführen dieses Beispiels den folgenden Code in ein Formular ein, das einen DataGridView namen dataGridView1enthält. In C# müssen Sie das Ereignis auch mit dem Sorted Ereignishandler verbinden.

private void dataGridView1_Sorted(object sender, EventArgs e)
{
    this.dataGridView1.FirstDisplayedCell = this.dataGridView1.CurrentCell;
}

Hinweise

Sie können diese Eigenschaft verwenden, um zu bestimmen, welche Zelle sich in der ersten Zeile und Spalte befindet, die derzeit im Steuerelement angezeigt wird. In der Regel befindet sich dies in der oberen linken Ecke, bei Sprachen von rechts nach links befindet es sich jedoch in der oberen rechten Ecke. Sie können diese Eigenschaft auch so festlegen, dass das Steuerelement zur angegebenen Zelle scrollt.

Gilt für:

Produkt Versionen
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

Weitere Informationen