DataGridView.ClearSelection Méthode

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Annule la sélection des cellules actuellement sélectionnées.

Surcharges

Nom	Description
ClearSelection(Int32, Int32, Boolean)	Annule la sélection de toutes les cellules actuellement sélectionnées, à l’exception de celle indiquée, en veillant éventuellement à ce que la cellule indiquée soit sélectionnée.
ClearSelection()	Efface la sélection actuelle en désélectionnant toutes les cellules sélectionnées.

ClearSelection(Int32, Int32, Boolean)

Source:

DataGridView.Methods.cs

Annule la sélection de toutes les cellules actuellement sélectionnées, à l’exception de celle indiquée, en veillant éventuellement à ce que la cellule indiquée soit sélectionnée.

protected:
 void ClearSelection(int columnIndexException, int rowIndexException, bool selectExceptionElement);

protected void ClearSelection(int columnIndexException, int rowIndexException, bool selectExceptionElement);

member this.ClearSelection : int * int * bool -> unit

Protected Sub ClearSelection (columnIndexException As Integer, rowIndexException As Integer, selectExceptionElement As Boolean)

Paramètres

columnIndexException

Int32

Index de colonne à exclure.

rowIndexException

Int32

Index de ligne à exclure.

selectExceptionElement

Boolean

true pour sélectionner la cellule exclue, la ligne ou la colonne ; false pour conserver son état d’origine.

Exceptions

ArgumentOutOfRangeException

columnIndexException est supérieur à l’index de colonne le plus élevé.

- ou -

columnIndexException est inférieur à -1 quand SelectionModeFullRowSelectest ; sinon, columnIndexException est inférieur à 0.

- ou -

rowIndexException est supérieur à l’index de ligne le plus élevé.

- ou -

rowIndexException est inférieur à -1 quand SelectionModeFullColumnSelectest ; sinon, rowIndexException est inférieur à 0.

Remarques

Une rowIndexException valeur de -1 représente un en-tête de colonne et une columnIndexException valeur de -1 représente un en-tête de ligne.

Cette méthode est utile pour effacer la sélection actuelle sans annuler la sélection de la cellule, de la ligne ou de la colonne indiquée par les index d’exception.

Si la valeur de propriété autorise la SelectionMode sélection individuelle de cellule, cette méthode définit la Selected propriété de chaque cellule falsesur , à l’exclusion de la cellule dans la ligne et la colonne spécifiées. Si la valeur de la propriété autorise la SelectionMode sélection complète de lignes ou de colonnes, cette méthode définit également la Selected propriété de chaque ligne ou colonne falsesur , à l’exclusion de la ligne ou de la colonne contenant la cellule spécifiée.

La cellule, la ligne ou la colonne exclue peut ou non être dans l’état sélectionné lorsque cette méthode est appelée. Cette méthode la sélectionne si la valeur du selectExceptionElement paramètre est true. Selon le mode de sélection, l’intégralité de la ligne ou de la colonne peut également être sélectionnée en conséquence.

Voir aussi

• SelectionMode
• Selected
• Selected
• DataGridView Control (Windows Forms)

ClearSelection()

Source:

DataGridView.Methods.cs

Efface la sélection actuelle en désélectionnant toutes les cellules sélectionnées.

public:
 void ClearSelection();

public void ClearSelection();

member this.ClearSelection : unit -> unit

Public Sub ClearSelection ()

Exemples

L’exemple de code suivant efface la sélection du DataGridView. Pour exécuter cet exemple, collez le code dans un formulaire qui contient un DataGridView nom dataGridView1 et un Button nommé clearSelectionButton, et vérifiez que tous les événements sont associés à leurs gestionnaires d’événements.

private void clearSelectionButton_Click(object sender, EventArgs e)
{
    dataGridView1.ClearSelection();
}

Private Sub clearSelectionButton_Click(ByVal sender As Object, _
    ByVal e As EventArgs) Handles clearSelectionButton.Click

    dataGridView1.ClearSelection()

End Sub

Remarques

Lorsque cette méthode est appelée, chaque colonne et la propriété de la Selected ligne sont définies falsesur .

Voir aussi

• DataGridView Control (Windows Forms)