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.
Dient zum Abrufen oder Festlegen der ersten Zelle, die derzeit in der DataGridView; normalerweise befindet sich diese Zelle in der oberen linken 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
Der erste DataGridViewCell , der derzeit im Steuerelement angezeigt wird.
- Attribute
Ausnahmen
Die angegebene Zelle beim Festlegen dieser Eigenschaft befindet sich nicht in der DataGridView.
Die angegebene Zelle beim Festlegen dieser Eigenschaft hat einen RowIndexColumnIndex Eigenschaftswert von -1, der angibt, dass es sich um eine Kopfzeilenzelle oder eine freigegebene Zelle handelt.
-oder-
Die angegebene Zelle beim Festlegen dieser Eigenschaft weist einen Visible Eigenschaftswert von false.
Beispiele
Im folgenden Codebeispiel wird veranschaulicht, wie Sie sicherstellen können, dass die aktuelle Zelle nach der Sortierung 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.
Zum Ausführen dieses Beispiels fügen Sie den folgenden Code in ein Formular ein, das einen benannten DataGridView Namen dataGridView1enthält. In C# müssen Sie das Sorted Ereignis auch mit dem 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
Mit dieser Eigenschaft können Sie 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, aber für Sprachen von rechts nach links befindet es sich in der oberen rechten Ecke. Sie können diese Eigenschaft auch so festlegen, dass das Steuerelement zur angegebenen Zelle scrollt.