DataGridView.ClearSelection Método

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Cancela a seleção das células selecionadas no momento.

Sobrecargas

ClearSelection(Int32, Int32, Boolean)	Cancela a seleção de todas as células selecionadas no momento, exceto a indicada, garantindo opcionalmente que a célula especificada esteja selecionada.
ClearSelection()	Limpa a seleção atual, desmarcando todas as células selecionadas.

ClearSelection(Int32, Int32, Boolean)

Cancela a seleção de todas as células selecionadas no momento, exceto a indicada, garantindo opcionalmente que a célula especificada esteja selecionada.

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)

Parâmetros

columnIndexException

Int32

O índice da coluna a ser excluído.

rowIndexException

Int32

O índice de linha a ser excluído.

selectExceptionElement

Boolean

true para selecionar a célula, linha ou coluna excluída; false para manter o estado original.

Exceções

ArgumentOutOfRangeException

columnIndexException é maior que o índice da coluna mais alto.

- ou - columnIndexException é menor que -1 quando SelectionMode for FullRowSelect; caso contrário, columnIndexException é menor que 0.

- ou - rowIndexException é maior que o índice de linha mais alto.

- ou - rowIndexException é menor que -1 quando SelectionMode for FullColumnSelect; caso contrário, rowIndexException é menor que 0.

Comentários

Um rowIndexException valor de -1 representa um cabeçalho de coluna e um columnIndexException valor de -1 representa um cabeçalho de linha.

Esse método é útil para limpar a seleção atual sem cancelar a seleção da célula, linha ou coluna indicada pelos índices de exceção.

Se o valor da SelectionMode propriedade permitir a seleção de célula individual, esse método definirá a Selected propriedade de cada célula como false, excluindo a célula na linha e coluna especificadas. Se o valor da SelectionMode propriedade permitir a seleção completa de linha ou coluna, esse método também definirá a Selected propriedade de cada linha ou coluna como false, excluindo a linha ou a coluna que contém a célula especificada.

A célula, linha ou coluna excluída pode ou não estar no estado selecionado quando esse método é chamado. Esse método o selecionará se o valor do selectExceptionElement parâmetro for true. Dependendo do modo de seleção, toda a linha ou coluna também pode ser selecionada como resultado.

Confira também

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

ClearSelection()

Limpa a seleção atual, desmarcando todas as células selecionadas.

public:
 void ClearSelection();

public void ClearSelection ();

member this.ClearSelection : unit -> unit

Public Sub ClearSelection ()

Exemplos

O exemplo de código a DataGridViewseguir limpa a seleção do . Para executar este exemplo, cole o código em um formulário que contém um DataGridView nome dataGridView1 e um Button nomeado clearSelectionButtone verifique se todos os eventos estão associados aos manipuladores de eventos.

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

Comentários

Quando esse método é chamado, cada coluna e propriedade da Selected linha é definida como false.

Confira também

• Controle DataGridView (Windows Forms)