DataGridView.ClearSelection 方法

定義

命名空間:

System.Windows.Forms

組件:

System.Windows.Forms.dll

取消目前已選取的儲存格。

多載

名稱	Description
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 當 SelectionMode 是 FullRowSelect時 小於 -1;否則 columnIndexException 小於 0。

-或-

rowIndexException 大於最高的行指數。

-或-

rowIndexException 當 SelectionMode 是 FullColumnSelect時 小於 -1;否則 rowIndexException 小於 0。

備註

rowIndexException-1 代表欄位標頭，columnIndexException-1 代表列標頭。

此方法有助於清除目前的選取，而不取消例外索引所指示的儲存格、列或欄位的選取。

若屬性 SelectionMode 值允許選擇單一格子，此方法將每個格子的性質設 Selected 為 false，排除列列中指定的格子。 若屬性 SelectionMode 值允許完整選取列或欄，此方法也會將每個列或欄的屬性設 Selected 為 false，但不含包含指定儲存格的列或欄。

被排除的儲存格、列或欄位在呼叫此方法時可能處於選擇狀態，也可能不在。 此方法選擇該參數值true為 selectExceptionElement 。 根據選擇模式，整個列或欄位也可能被選取。

另請參閱

• 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 named dataGridView1 和 ButtonclearSelectionButtonnamed 的表單，並確保所有事件都與其事件處理器相關聯。

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）