DataGridView.ClearSelection DataGridView.ClearSelection DataGridView.ClearSelection DataGridView.ClearSelection Method

定義

現在選択されているセルの選択を解除します。Cancels the selection of currently selected cells.

オーバーロード

ClearSelection(Int32, Int32, Boolean) ClearSelection(Int32, Int32, Boolean) ClearSelection(Int32, Int32, Boolean) ClearSelection(Int32, Int32, Boolean)

指定されたセルを除いて、選択されているすべてのセルの選択を解除します。オプションで、指定されたセルが選択されるようにします。Cancels the selection of all currently selected cells except the one indicated, optionally ensuring that the indicated cell is selected.

ClearSelection() ClearSelection() ClearSelection() ClearSelection()

選択されているすべてのセルの選択を解除して、現在の選択を解除します。Clears the current selection by unselecting all selected cells.

ClearSelection(Int32, Int32, Boolean) ClearSelection(Int32, Int32, Boolean) ClearSelection(Int32, Int32, Boolean) ClearSelection(Int32, Int32, Boolean)

指定されたセルを除いて、選択されているすべてのセルの選択を解除します。オプションで、指定されたセルが選択されるようにします。Cancels the selection of all currently selected cells except the one indicated, optionally ensuring that the indicated cell is selected.

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 Int32 Int32 Int32

除外される列インデックス。The column index to exclude.

rowIndexException
Int32 Int32 Int32 Int32

除外される行インデックス。The row index to exclude.

selectExceptionElement
Boolean Boolean Boolean Boolean

除外されたセル、行、または列を選択する場合は true。元の状態を保持する場合は falsetrue to select the excluded cell, row, or column; false to retain its original state.

例外

columnIndexException が最も大きい列のインデックスより大きくなっています。columnIndexException is greater than the highest column index.

または-or- columnIndexExceptionSelectionMode の場合は、 FullRowSelectが -1 未満です。それ以外の場合は、 columnIndexException が 0 未満です。columnIndexException is less than -1 when SelectionMode is FullRowSelect; otherwise, columnIndexException is less than 0.

または-or- rowIndexException が最も大きい行のインデックスより大きくなっています。rowIndexException is greater than the highest row index.

- または --or- SelectionModeFullColumnSelect の場合は、rowIndexException が -1 未満です。それ以外の場合は、rowIndexException が 0 未満です。rowIndexException is less than -1 when SelectionMode is FullColumnSelect; otherwise, rowIndexException is less than 0.

注釈

値-1 は列ヘッダー columnIndexExceptionを表し、値-1 は行ヘッダーを表します。 rowIndexExceptionA rowIndexException value of -1 represents a column header, and a columnIndexException value of -1 represents a row header.

このメソッドは、例外インデックスによって示されるセル、行、または列の選択をキャンセルせずに、現在の選択範囲をクリアする場合に便利です。This method is useful to clear the current selection without canceling the selection of the cell, row, or column indicated by the exception indexes.

プロパティ値で個々のセルを選択できる場合、このメソッドSelectedは、指定されfalseた行と列のセルを除いて、各セルのプロパティをに設定します。 SelectionModeIf the SelectionMode property value allows individual cell selection, this method sets the Selected property of each cell to false, excluding the cell in the row and column specified. プロパティ値SelectionModeによって行または列の完全選択が許可されSelectedている場合、このメソッドはfalse、指定したセルを含む行または列を除く、各行または列のプロパティもに設定します。If the SelectionMode property value allows full row or column selection, this method also sets the Selected property of each row or column to false, excluding the row or column containing the specified cell.

このメソッドを呼び出すと、除外されたセル、行、または列が選択された状態になる場合と、存在しない場合があります。The excluded cell, row, or column may or may not be in the selected state when this method is called. このメソッドは、 selectExceptionElementパラメーター値がの場合にそれをtrue選択します。This method selects it if the selectExceptionElement parameter value is true. 選択モードによっては、行または列全体が結果として選択されることもあります。Depending on the selection mode, the entire row or column may also be selected as a result.

こちらもご覧ください

ClearSelection() ClearSelection() ClearSelection() ClearSelection()

選択されているすべてのセルの選択を解除して、現在の選択を解除します。Clears the current selection by unselecting all selected cells.

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

次のコード例では、 DataGridViewの選択を解除します。The following code example clears the selection of the DataGridView. この例を実行するDataGridViewには、とdataGridView1 Button clearSelectionButtonいう名前のを含むフォームにコードを貼り付け、すべてのイベントがイベントハンドラーに関連付けられていることを確認します。To run this example, paste the code into a form that contains a DataGridView named dataGridView1 and a Button named clearSelectionButton, and ensure all events are associated with their event handlers.

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設定されます。When this method is called, each column and row's Selected property is set to false.

こちらもご覧ください

適用対象