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

ClearSelection(Int32, Int32, Boolean)	Annule la sélection de toutes les cellules actuellement sélectionnées, à l’exception de celle qui est indiquée, en vérifiant éventuellement que la cellule indiquée est sélectionnée.
ClearSelection()	Efface la sélection actuelle en désélectionnant toutes les cellules sélectionnées.

ClearSelection(Int32, Int32, Boolean)

Annule la sélection de toutes les cellules actuellement sélectionnées, à l’exception de celle qui est indiquée, en vérifiant éventuellement que la cellule indiquée est 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 la colonne à exclure.

rowIndexException

Int32

Index de la ligne à exclure.

selectExceptionElement

Boolean

true pour sélectionner la cellule, ligne ou colonne exclue ; 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 SelectionMode est FullRowSelect ; 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 SelectionMode est FullColumnSelect ; sinon, rowIndexException est inférieur à 0.

Remarques

La rowIndexException valeur -1 représente un en-tête de colonne et la columnIndexException valeur -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 la propriété autorise la SelectionMode sélection de cellule individuelle, 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 SelectionMode propriété autorise la 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, contrôle (Windows Forms)

ClearSelection()

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, la propriété de chaque colonne et ligne Selected est définie falsesur .

Voir aussi

• DataGridView, contrôle (Windows Forms)