DataGridView.AreAllCellsSelected(Boolean) Methode

Referenz

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Gibt einen Wert zurück, der angibt, ob derzeit alle DataGridView-Zellen ausgewählt sind.

public:
 bool AreAllCellsSelected(bool includeInvisibleCells);

public bool AreAllCellsSelected (bool includeInvisibleCells);

member this.AreAllCellsSelected : bool -> bool

Public Function AreAllCellsSelected (includeInvisibleCells As Boolean) As Boolean

Parameter

includeInvisibleCells: Boolean

true, um die Zeilen und die Spalten mit dem Visible-Eigenschaftswert false einzuschließen, andernfalls false.

Gibt zurück

Boolean

true, wenn alle (oder alle sichtbaren) Zellen ausgewählt sind oder wenn keine (oder keine sichtbaren) Zellen vorhanden sind, andernfalls false.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Sie diese Methode verwenden, um Berechnungen mit der SelectedCells Auflistung zu vermeiden.

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");
        }
    }
}

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

Hinweise

Die SelectedCells-Sammlung arbeitet bei großen Auswahlen nicht effizient. Um festzustellen, ob alle Zellen in DataGridView ausgewählt wurden, ehe Sie auf den Inhalt der SelectedCells-Sammlung zugreifen, überprüfen Sie den Rückgabewert der AreAllCellsSelected-Methode. Diese Methode kann jedoch dazu führen, dass die Freigabe von Zeilen aufgehoben wird. Weitere Informationen zur DataGridView Leistung finden Sie unter Bewährte Methoden für die Skalierung des Windows Forms DataGridView-Steuerelements.

Gilt für:

Freigeben über