DataGridView.AreAllCellsSelected メソッドとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

DataGridView.AreAllCellsSelected メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

すべての DataGridView セルが現在選択されているかどうかを示す値を返します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Public Function AreAllCellsSelected ( _
    includeInvisibleCells As Boolean _
) As Boolean

Visual Basic (使用法)

Dim instance As DataGridView
Dim includeInvisibleCells As Boolean
Dim returnValue As Boolean

returnValue = instance.AreAllCellsSelected(includeInvisibleCells)

public bool AreAllCellsSelected (
    bool includeInvisibleCells
)

C++

public:
bool AreAllCellsSelected (
    bool includeInvisibleCells
)

public boolean AreAllCellsSelected (
    boolean includeInvisibleCells
)

JScript

public function AreAllCellsSelected (
    includeInvisibleCells : boolean
) : boolean

パラメータ

includeInvisibleCells: Visible プロパティの値が false の行および列を含める場合は true。それ以外の場合は false。

戻り値
表示されているすべてのセルが選択されている場合、または表示されているセルが存在しない場合は true。それ以外の場合は false。

解説

SelectedCells コレクションは、大量のセルが選択されている場合の処理効率があまりよくありません。SelectedCells コレクションの内容にアクセスする前に DataGridView 内のすべてのセルが選択されているかどうかを確認するには、AreAllCellsSelected メソッドの戻り値をチェックします。ただし、このメソッドを実行すると、行の共有が解除される場合があります。DataGridView のパフォーマンスの詳細については、「Windows フォーム DataGridView コントロールを拡張するための推奨される手順」を参照してください。

使用例

このメソッドを使用して、SelectedCells コレクションに関係する計算を回避するコード例を次に示します。

Visual Basic

Private Sub selectedCellsButton_Click( _
    ByVal sender As Object,
 ByVal e As System.EventArgs) _
    Handles selectedCellsButton.Click

    Dim selectedCellCount As Integer
 = _
        dataGridView1.GetCellCount(DataGridViewElementStates.Selected)

    If selectedCellCount > 0 Then

        If dataGridView1.AreAllCellsSelected(True)
 Then

            MessageBox.Show("All cells are selected",
 "Selected Cells")

        Else

            Dim sb As New
 System.Text.StringBuilder()

            Dim i As Integer
            For i = 0 To selectedCellCount
 - 1

                sb.Append("Row: ")
                sb.Append(dataGridView1.SelectedCells(i).RowIndex _
                    .ToString())
                sb.Append(", Column: ")
                sb.Append(dataGridView1.SelectedCells(i).ColumnIndex _
                    .ToString())
                sb.Append(Environment.NewLine)

            Next i

            sb.Append("Total: " + selectedCellCount.ToString())
            MessageBox.Show(sb.ToString(), "Selected Cells")

        End If

    End If

End Sub

private void selectedCellsButton_Click(object
 sender, System.EventArgs e)
{
    Int32 selectedCellCount =
        dataGridView1.GetCellCount(DataGridViewElementStates.Selected);
    if (selectedCellCount > 0)
    {
        if (dataGridView1.AreAllCellsSelected(true))
        {
            MessageBox.Show("All cells are selected", "Selected Cells");
        }
        else
        {
            System.Text.StringBuilder sb =
                new System.Text.StringBuilder();

            for (int i = 0;
                i < selectedCellCount; i++)
            {
                sb.Append("Row: ");
                sb.Append(dataGridView1.SelectedCells[i].RowIndex
                    .ToString());
                sb.Append(", Column: ");
                sb.Append(dataGridView1.SelectedCells[i].ColumnIndex
                    .ToString());
                sb.Append(Environment.NewLine);
            }

            sb.Append("Total: " + selectedCellCount.ToString());
            MessageBox.Show(sb.ToString(), "Selected Cells");
        }
    }
}