DataGridView.AreAllCellsSelected(Boolean) Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Devolve um valor que indica se todas as DataGridView células estão atualmente selecionadas.
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.
Devoluções
true se todas as células (ou todas as células visíveis) forem selecionadas ou se não houver células (ou não houver células visíveis); caso contrário, false.
Exemplos
O exemplo de código seguinte ilustra como usar este 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
Observações
A coleção SelectedCells não funciona de forma eficiente com grandes seleções. Para determinar se todas as células no DataGridView foram selecionadas antes de acessar o conteúdo da coleção SelectedCells, verifique o valor de retorno do método AreAllCellsSelected. No entanto, este método pode fazer com que as linhas se tornem não partilhadas. Para mais informações sobre o desempenho do DataGridView, consulte Boas Práticas para Escalar o Controlo Windows Forms DataGridView.