DataGridView.ClearSelection 方法

定义

取消对当前选定的单元格的选择。

重载

ClearSelection(Int32, Int32, Boolean)

取消选择当前选定的所有单元格(所指示的单元格除外),可以选择确保所指示的单元格处于选定状态。

ClearSelection()

通过取消选择所有的选定单元格来清除当前的选择。

ClearSelection(Int32, Int32, Boolean)

取消选择当前选定的所有单元格(所指示的单元格除外),可以选择确保所指示的单元格处于选定状态。

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

例外

columnIndexException 大于最高的列索引。

  • 或 - 当 SelectionModeFullRowSelect 时,columnIndexException 小于 -1;否则 columnIndexException 小于 0。

  • 或 - rowIndexException 大于最高的行索引。

  • 或 - 当 SelectionModeFullColumnSelect 时,rowIndexException 小于 -1;否则 rowIndexException 小于 0。

注解

rowIndexException值 -1 表示列标题,columnIndexException值为 -1 表示行标题。

此方法可用于清除当前所选内容,而无需取消异常索引所指示的单元格、行或列的选择。

SelectionMode如果属性值允许单个单元格选择,此方法会将每个单元格的属性设置为Selectedfalse,不包括指定的行和列中的单元格。 SelectionMode如果属性值允许完整行或列选择,此方法还会将每一行或列的属性设置为Selectedfalse,不包括包含指定单元格的行或列。

调用此方法时,排除的单元格、行或列可能处于所选状态。 如果参数值为 true,则此方法选择它selectExceptionElement。 根据选择模式,也可以选择整个行或列作为结果。

另请参阅

适用于

ClearSelection()

通过取消选择所有的选定单元格来清除当前的选择。

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

示例

下面的代码示例清除所选内容 DataGridView。 若要运行此示例,请将代码粘贴到包含 DataGridView 命名 dataGridView1Button 命名 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

另请参阅

适用于