DataGridView.ClearSelection Método

Definición

Cancela la selección de las celdas seleccionadas actualmente.Cancels the selection of currently selected cells.

Sobrecargas

ClearSelection(Int32, Int32, Boolean)

Cancela la selección de todas las celdas seleccionadas actualmente salvo la indicada y, opcionalmente, garantiza que la celda indicada esté seleccionada.Cancels the selection of all currently selected cells except the one indicated, optionally ensuring that the indicated cell is selected.

ClearSelection()

Borra la selección actual anulando la selección de todas las celdas seleccionadas.Clears the current selection by unselecting all selected cells.

ClearSelection(Int32, Int32, Boolean)

Cancela la selección de todas las celdas seleccionadas actualmente salvo la indicada y, opcionalmente, garantiza que la celda indicada esté seleccionada.Cancels the selection of all currently selected cells except the one indicated, optionally ensuring that the indicated cell is selected.

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

Índice de la columna que se va a excluir.The column index to exclude.

rowIndexException
Int32

Índice de la fila que se va a excluir.The row index to exclude.

selectExceptionElement
Boolean

Es true para seleccionar la celda, fila o columna excluida; false para conservar su estado original.true to select the excluded cell, row, or column; false to retain its original state.

Excepciones

columnIndexException es mayor que el índice de columna más alto.columnIndexException is greater than the highest column index.

O bien-or- columnIndexException es menor que -1 cuando SelectionMode es FullRowSelect; de lo contrario, columnIndexException es menor que 0.columnIndexException is less than -1 when SelectionMode is FullRowSelect; otherwise, columnIndexException is less than 0.

o bien-or- rowIndexException es mayor que el índice de fila más alto.rowIndexException is greater than the highest row index.

o bien-or- rowIndexException es menor que -1 cuando SelectionMode es FullColumnSelect; de lo contrario, rowIndexException es menor que 0.rowIndexException is less than -1 when SelectionMode is FullColumnSelect; otherwise, rowIndexException is less than 0.

Comentarios

Un valor rowIndexException de-1 representa un encabezado de columna y un valor de columnIndexException de-1 representa un encabezado de fila.A rowIndexException value of -1 represents a column header, and a columnIndexException value of -1 represents a row header.

Este método es útil para borrar la selección actual sin cancelar la selección de la celda, fila o columna indicada por los índices de excepción.This method is useful to clear the current selection without canceling the selection of the cell, row, or column indicated by the exception indexes.

Si el valor de la propiedad SelectionMode permite seleccionar celdas individuales, este método establece la propiedad Selected de cada celda en false, excluyendo la celda de la fila y la columna especificadas.If the SelectionMode property value allows individual cell selection, this method sets the Selected property of each cell to false, excluding the cell in the row and column specified. Si el valor de la propiedad SelectionMode permite la selección de filas o columnas completas, este método también establece la propiedad Selected de cada fila o columna en false, excepto la fila o columna que contiene la celda especificada.If the SelectionMode property value allows full row or column selection, this method also sets the Selected property of each row or column to false, excluding the row or column containing the specified cell.

La celda, fila o columna excluida puede estar o no en el estado seleccionado cuando se llama a este método.The excluded cell, row, or column may or may not be in the selected state when this method is called. Este método lo selecciona si el valor del parámetro selectExceptionElement es true.This method selects it if the selectExceptionElement parameter value is true. En función del modo de selección, es posible que también se seleccione la fila o columna completa como resultado.Depending on the selection mode, the entire row or column may also be selected as a result.

Consulte también:

ClearSelection()

Borra la selección actual anulando la selección de todas las celdas seleccionadas.Clears the current selection by unselecting all selected cells.

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

Ejemplos

En el ejemplo de código siguiente se borra la selección del DataGridView.The following code example clears the selection of the DataGridView. Para ejecutar este ejemplo, pegue el código en un formulario que contenga un DataGridView denominado dataGridView1 y un Button denominado clearSelectionButton, y asegúrese de que todos los eventos estén asociados a sus controladores de eventos.To run this example, paste the code into a form that contains a DataGridView named dataGridView1 and a Button named clearSelectionButton, and ensure all events are associated with their event handlers.

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

Comentarios

Cuando se llama a este método, la propiedad Selected de cada columna y fila se establece en false.When this method is called, each column and row's Selected property is set to false.

Consulte también:

Se aplica a