Partilhar via

DataGridView.ClearSelection Método

Definição

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

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

Sobrecargas

Nome Description
ClearSelection(Int32, Int32, Boolean)

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

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

ClearSelection(Int32, Int32, Boolean)

Origem:
DataGridView.Methods.cs
Origem:
DataGridView.Methods.cs
Origem:
DataGridView.Methods.cs
Origem:
DataGridView.Methods.cs
Origem:
DataGridView.Methods.cs

Cancela a seleção de todas as células selecionadas no momento, exceto aquela indicada, opcionalmente garantindo que a célula indicada 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 de coluna a ser excluído.

rowIndexException
Int32

O índice de linha a ser excluído.

selectExceptionElement
Boolean

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

Exceções

ArgumentOutOfRangeException

columnIndexException é maior 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 que o índice de linha mais alto.

- ou -

rowIndexException é menor que -1 quando SelectionMode é 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, falseexcluindo a célula na linha e coluna especificada. Se o valor da SelectionMode propriedade permitir a seleção de linha ou coluna completa, esse método também definirá a Selected propriedade de cada linha ou coluna como 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 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

Aplica-se a

ClearSelection()

Origem:
DataGridView.Methods.cs
Origem:
DataGridView.Methods.cs
Origem:
DataGridView.Methods.cs
Origem:
DataGridView.Methods.cs
Origem:
DataGridView.Methods.cs

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 nome 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 propriedade de Selected coluna e linha é definida como false.

Confira também

Aplica-se a