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.

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

Valeur de propriété

Première DataGridViewCell affichée actuellement dans le contrôle.

Attributs

Exceptions

La cellule spécifiée lors de la définition de cette propriété n’est pas dans le 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.

- ou -

La cellule spécifiée lors de la définition de cette propriété a une valeur de propriété Visible de false.

Exemples

L’exemple de code suivant montre comment s’assurer que la cellule active est visible après le tri. Ce code fonctionne uniquement avec un contrôle indépendant DataGridView . Avec un DataGridView contrôle lié à une source de données externe, la cellule active n’est pas automatiquement conservée lors du tri.

Pour exécuter cet exemple, collez le code suivant dans un formulaire qui contient un DataGridView nommé dataGridView1. En C#, vous devez également connecter l’événement Sorted au gestionnaire d’événements.

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ées dans le contrôle. En règle générale, il se trouve dans le coin supérieur gauche, mais pour les langues de droite à gauche, il se trouve dans l’angle supérieur droit. Vous pouvez également définir cette propriété pour faire défiler le contrôle jusqu’à la cellule indiquée.

S’applique à

Voir aussi