DataGridView.ClearSelection Metodo

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Annulla la selezione delle celle attualmente selezionate.

Overload

ClearSelection(Int32, Int32, Boolean)	Annulla la selezione di tutte le celle attualmente selezionate, ad eccezione di quella indicata, assicurando eventualmente che la cella indicata sia selezionata.
ClearSelection()	Cancella la selezione corrente deselezionando tutte le celle selezionate.

ClearSelection(Int32, Int32, Boolean)

Annulla la selezione di tutte le celle attualmente selezionate, ad eccezione di quella indicata, assicurando eventualmente che la cella indicata sia selezionata.

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)

Parametri

columnIndexException

Int32

Indice di colonna da escludere.

rowIndexException

Int32

Indice di riga da escludere.

selectExceptionElement

Boolean

true per selezionare la cella, la riga o la colonna esclusa, false per mantenere lo stato originale.

Eccezioni

ArgumentOutOfRangeException

columnIndexException è maggiore dell'indice di colonna più alto.

-oppure-

columnIndexException è minore di -1 quando SelectionMode è FullRowSelect; in caso contrario, columnIndexException è minore di 0.

-oppure-

rowIndexException è maggiore dell'indice di riga più alto.

-oppure-

rowIndexException è minore di -1 quando SelectionMode è FullColumnSelect; in caso contrario, rowIndexException è minore di 0.

Commenti

Un rowIndexException valore di -1 rappresenta un'intestazione di colonna e un columnIndexException valore di -1 rappresenta un'intestazione di riga.

Questo metodo è utile per cancellare la selezione corrente senza annullare la selezione della cella, della riga o della colonna indicata dagli indici di eccezione.

Se il valore della SelectionMode proprietà consente la selezione di singole celle, questo metodo imposta la Selected proprietà di ogni cella su false, escluso la cella nella riga e nella colonna specificata. Se il valore della proprietà consente la SelectionMode selezione completa di righe o colonne, questo metodo imposta anche la Selected proprietà di ogni riga o colonna su false, escludendo la riga o la colonna contenente la cella specificata.

La cella, la riga o la colonna esclusi possono essere nello stato selezionato quando viene chiamato questo metodo. Questo metodo lo seleziona se il valore del selectExceptionElement parametro è true. A seconda della modalità di selezione, l'intera riga o colonna può essere selezionata anche come risultato.

Vedi anche

• SelectionMode
• Selected
• Selected
• Controllo DataGridView (Windows Form)

ClearSelection()

Cancella la selezione corrente deselezionando tutte le celle selezionate.

public:
 void ClearSelection();

public void ClearSelection ();

member this.ClearSelection : unit -> unit

Public Sub ClearSelection ()

Esempio

Nell'esempio DataGridViewdi codice seguente viene cancellata la selezione di . Per eseguire questo esempio, incollare il codice in un modulo contenente un nome e un DataGridViewButton denominato dataGridView1clearSelectionButtone assicurarsi che tutti gli eventi siano associati ai gestori eventi.

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

Commenti

Quando questo metodo viene chiamato, ogni colonna e la proprietà della Selected riga è impostata su false.

Vedi anche

• Controllo DataGridView (Windows Form)