DataGridView.AreAllCellsSelected(Boolean) Método
Definição
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 DataGridView células estão selecionadas no momento.
public:
bool AreAllCellsSelected(bool includeInvisibleCells);public bool AreAllCellsSelected(bool includeInvisibleCells);member this.AreAllCellsSelected : bool -> boolPublic Function AreAllCellsSelected (includeInvisibleCells As Boolean) As BooleanParâmetros
- includeInvisibleCells
- Boolean
true para incluir as linhas e colunas com Visible valores de propriedade de false; caso contrário, false.
Retornos
true se todas as células (ou todas as células visíveis) estiverem selecionadas ou se não houver células (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 coleção SelectedCells não se desempenha eficientemente 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, verifique 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 desempenho, consulte Best Practices for Scaling the Windows Forms DataGridView Control.