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 Если значение свойства разрешает выделение отдельных ячеек, этот метод задает Selected для свойства каждой ячейки falseзначение, за исключением ячейки в указанной строке и столбце. SelectionMode Если значение свойства разрешает полный выбор строки или столбца, этот метод также задает Selected свойство каждой строки или столбцаfalse, за исключением строки или столбца, содержащего указанную ячейку.

Исключенная ячейка, строка или столбец может находиться в выбранном состоянии при вызове этого метода. Этот метод выбирает его, 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 и именованныйclearSelectionButtonButton, и убедитесь, что все события связаны с их обработчиками событий.

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)