DataGridView.FirstDisplayedCell Eigenschaft
Definition
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
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 dataGridView1
enthä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.