DataGridView.FirstDisplayedCell Propriété

Définition

Obtient ou définit la première cellule actuellement affichée dans le DataGridView ; en général, cette cellule se trouve dans le coin supérieur gauche.Gets or sets the first cell currently displayed in the DataGridView; typically, this cell is in the upper left corner.

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; }
member this.FirstDisplayedCell : System.Windows.Forms.DataGridViewCell with get, set
Public Property FirstDisplayedCell As DataGridViewCell

Valeur de propriété

Première DataGridViewCell affichée actuellement dans le contrôle.The first DataGridViewCell currently displayed in the control.

Attributs

Exceptions

La cellule spécifiée lors de la définition de cette propriété n’est pas dans le DataGridView.The specified cell when setting this property is not in the DataGridView.

La cellule spécifiée lors de la définition de cette propriété a une valeur de propriété RowIndex ou ColumnIndex de -1, indiquant qu’il s’agit d’une cellule d’en-tête ou d’une cellule partagée.The specified cell when setting this property has a RowIndex or ColumnIndex property value of -1, indicating that it is a header cell or a shared cell.

- ou --or- La cellule spécifiée lors de la définition de cette propriété a une valeur de propriété Visible de false.The specified cell when setting this property has a Visible property value of false.

Exemples

L’exemple de code suivant montre comment s’assurer que la cellule active est visible après le tri.The following code example illustrates how to ensure that the current cell is visible after sorting. Ce code fonctionne uniquement avec un contrôle de DataGridView indépendant.This code works only with an unbound DataGridView control. Lorsqu’un contrôle de DataGridView est lié à une source de données externe, la cellule active n’est pas automatiquement rendue persistante lors du tri.With a DataGridView control bound to an external data source, the current cell is not automatically persisted when sorting.

Pour exécuter cet exemple, collez le code suivant dans un formulaire qui contient un DataGridView nommé dataGridView1.To run this example, paste the following code into a form that contains a DataGridView named dataGridView1. Dans C#, vous devez également connecter l’événement Sorted au gestionnaire d’événements.In C#, you must also connect the Sorted event to the event handler.

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

Remarques

Vous pouvez utiliser cette propriété pour déterminer quelle cellule se trouve dans la première ligne et la première colonne actuellement affichée dans le contrôle.You can use this property to determine which cell is in the first row and column currently displayed in the control. En général, il se trouve dans le coin supérieur gauche, mais pour les langues de droite à gauche, il se trouve dans le coin supérieur droit.Typically, this is in the upper left corner, but for right-to-left languages, it is in the upper right corner. Vous pouvez également définir cette propriété pour faire défiler le contrôle vers la cellule indiquée.You can also set this property to scroll the control to the indicated cell.

S’applique à

Voir aussi