DataGridView.ClearSelection Метод

Определение

Пространство имен:

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

Отменяет выделение ячеек, выбранных в данный момент.

Перегрузки

ClearSelection(Int32, Int32, Boolean)	Отменяет выбор всех выделенных в данный момент ячеек, за исключением одной указанной ячейки, при необходимости выделяя указанную ячейку.
ClearSelection()	Отменяет текущее выделение посредством снятия выделения всех выбранных ячеек.

ClearSelection(Int32, Int32, Boolean)

Исходный код:

DataGridView.Methods.cs

Отменяет выбор всех выделенных в данный момент ячеек, за исключением одной указанной ячейки, при необходимости выделяя указанную ячейку.

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)

Параметры

columnIndexException

Int32

Исключаемый индекс столбца.

rowIndexException

Int32

Исключаемый индекс строки.

selectExceptionElement

Boolean

Значение true, чтобы выбрать исключенную ячейку, строку или столбец; значение false, чтобы сохранить их исходное состояние.

Исключения

ArgumentOutOfRangeException

columnIndexException больше наибольшего индекса столбца.

-или-

columnIndexException меньше –1, если SelectionMode — FullRowSelect; в противном случае columnIndexException меньше 0.

-или-

rowIndexException больше наибольшего индекса строки.

-или-

rowIndexException меньше –1, если SelectionMode — FullColumnSelect; в противном случае rowIndexException меньше 0.

Комментарии

Значение rowIndexException -1 представляет заголовок столбца, а columnIndexException значение -1 — заголовок строки.

Этот метод полезен для очистки текущего выделения без отмены выделения ячейки, строки или столбца, указанных индексами исключений.

SelectionMode Если значение свойства позволяет выбирать отдельные ячейки, этот метод задает свойству Selectedfalseкаждой ячейки значение , за исключением ячейки в указанной строке и столбце. SelectionMode Если значение свойства допускает полный выбор строк или столбцов, этот метод также задает свойству Selectedfalseкаждой строки или столбца значение , за исключением строки или столбца, содержащих указанную ячейку.

Исключенные ячейки, строки или столбца могут находиться в выбранном состоянии при вызове этого метода. Этот метод выбирает его, если selectExceptionElement параметр имеет trueзначение . В зависимости от режима выбора в результате также может быть выбрана вся строка или столбец.

См. также раздел

• SelectionMode
• Selected
• Selected
• элемент управления DataGridView (Windows Forms)

ClearSelection()

Исходный код:

DataGridView.Methods.cs

Отменяет текущее выделение посредством снятия выделения всех выбранных ячеек.

public:
 void ClearSelection();

public void ClearSelection ();

member this.ClearSelection : unit -> unit

Public Sub ClearSelection ()

Примеры

В следующем примере кода очищается выбор DataGridViewэлемента . Чтобы запустить этот пример, вставьте код в форму, содержащую DataGridView именованные dataGridView1 и Button именованные clearSelectionButton, и убедитесь, что все события связаны с их обработчиками событий.

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

Комментарии

При вызове этого метода каждому столбцу и свойству Selected строки присваивается значение false.

См. также раздел

• элемент управления DataGridView (Windows Forms)