DataGridView.FirstDisplayedCell Eigenschaft

Referenz

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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.

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)]
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

Eigenschaftswert

DataGridViewCell

Die erste derzeit im Steuerelement angezeigte DataGridViewCell.

Attribute: BrowsableAttribute

Ausnahmen

ArgumentException

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

InvalidOperationException

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;
}

Private Sub dataGridView1_Sorted(ByVal sender As Object, _
    ByVal e As System.EventArgs) Handles dataGridView1.Sorted

    Me.dataGridView1.FirstDisplayedCell = Me.dataGridView1.CurrentCell

End Sub

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: