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セルを選択できる場合、このメソッドは、指定された行と列のセルを除き、各セルの プロパティを にfalse設定Selectedします。 プロパティ値で行または列を SelectionMode 完全に選択できる場合、このメソッドでは、指定したセルを Selected 含む行または列を除き、各行または列のプロパティも に false設定されます。

除外されたセル、行、または列は、このメソッドが呼び出されたときに選択した状態にある場合とそうでない場合があります。 このメソッドは、パラメーター値trueが の場合にselectExceptionElement選択します。 選択モードによっては、結果として行または列全体が選択される場合もあります。

こちらもご覧ください

適用対象

ClearSelection()

選択されているすべてのセルの選択を解除して、現在の選択を解除します。

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

次のコード例では、 の選択をクリアします DataGridView。 この例を実行するには、名前付き と 名前clearSelectionButton付きの dataGridView1 を含むDataGridViewフォームにコードをButton貼り付け、すべてのイベントがイベント ハンドラーに関連付けられていることを確認します。

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設定されます。

こちらもご覧ください

適用対象