DataGridView.ClearSelection Método

Definição

Espaço de Nomes:
System.Windows.Forms
Assemblagem:
System.Windows.Forms.dll

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

Sobrecargas

Name Description
ClearSelection(Int32, Int32, Boolean)

Cancela a seleção de todas as células atualmente selecionadas, exceto a indicada, garantindo opcionalmente que a célula indicada está selecionada.
ClearSelection()

Limpa a seleção atual ao desmarcar todas as células selecionadas.

ClearSelection(Int32, Int32, Boolean)

Cancela a seleção de todas as células atualmente selecionadas, exceto a indicada, garantindo opcionalmente que a célula indicada está 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 para excluir.

rowIndexException
Int32

O índice de linhas para excluir.

selectExceptionElement
Boolean

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

Exceções

ArgumentOutOfRangeException

columnIndexException é maior do que o índice de coluna mais alto.

-ou-

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

-ou-

rowIndexException é maior do que o índice de linhas mais alto.

-ou-

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

Observações

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

Este método é útil para eliminar 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élulas individuais, este método define a Selected propriedade de cada célula para false, excluindo a célula na linha e coluna especificadas. Se o valor da SelectionMode propriedade permitir a seleção completa de linhas ou colunas, este método também define a Selected propriedade de cada linha ou coluna para false, excluindo a linha ou 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 este método é chamado. Este método seleciona-o se o selectExceptionElement valor do parâmetro for true. Dependendo do modo de seleção, toda a linha ou coluna também pode ser selecionada como resultado.

Ver também

Aplica-se a

ClearSelection()

Limpa a seleção atual ao desmarcar todas as células selecionadas.

public:
 void ClearSelection();
public void ClearSelection();
member this.ClearSelection : unit -> unit
Public Sub ClearSelection ()

Exemplos

O seguinte exemplo de código elimina a seleção do DataGridView. Para executar este exemplo, cole o código num formulário que contenha um DataGridView nome dataGridView1 e um Button nomeado clearSelectionButton, e assegure que todos os eventos estão associados aos seus gestores 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

Observações

Quando este método é chamado, a propriedade de Selected cada coluna e linha é definida como false.

Ver também

Aplica-se a