DataGridView.AreAllCellsSelected(Boolean) Método

Referência

Definição

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Retorna um valor que indica se todas as células DataGridView estão selecionadas no momento.

public:
 bool AreAllCellsSelected(bool includeInvisibleCells);

public bool AreAllCellsSelected (bool includeInvisibleCells);

member this.AreAllCellsSelected : bool -> bool

Public Function AreAllCellsSelected (includeInvisibleCells As Boolean) As Boolean

Parâmetros

includeInvisibleCells: Boolean

true para incluir linhas e colunas com valores da propriedade Visible de false; caso contrário, false.

Retornos

Boolean

true se todas as células (ou todas as células visíveis) forem selecionadas ou se não houver nenhuma célula (ou nenhuma célula visível); caso contrário, false.

Exemplos

O exemplo de código a seguir ilustra como usar esse método para evitar cálculos envolvendo a SelectedCells coleção.

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

Comentários

A SelectedCells coleção não tem um desempenho eficiente com seleções grandes. Para determinar se todas as células no DataGridView foram selecionadas antes de acessar o conteúdo da SelectedCells coleção, marcar o valor retornado do AreAllCellsSelected método . No entanto, esse método pode fazer com que as linhas se tornem não compartilhadas. Para obter mais informações sobre DataGridView o desempenho, consulte Práticas recomendadas para dimensionar o Windows Forms controle DataGridView.

Aplica-se a

Partilhar via