DataGridView.GetCellCount(DataGridViewElementStates) Método

Definição

Espaço de Nomes:
System.Windows.Forms
Assemblagem:
System.Windows.Forms.dll

Obtém o número de células que satisfazem o filtro fornecido.

public:
 int GetCellCount(System::Windows::Forms::DataGridViewElementStates includeFilter);
public int GetCellCount(System.Windows.Forms.DataGridViewElementStates includeFilter);
member this.GetCellCount : System.Windows.Forms.DataGridViewElementStates -> int
Public Function GetCellCount (includeFilter As DataGridViewElementStates) As Integer

Parâmetros

includeFilter
DataGridViewElementStates

Uma combinação bit a bit dos DataGridViewElementStates valores que especificam as células a contar.

Devoluções

Int32

O número de células que correspondem ao includeFilter parâmetro.

Exceções

ArgumentException

includeFilter inclui o valor ResizableSet.

Exemplos

O exemplo de código seguinte ilustra como usar este método para determinar se existem células selecionadas num DataGridView controlo. Neste exemplo, se alguma célula for selecionada, os seus valores são recuperados através do GetClipboardContent método e exibidos num TextBox controlo.

Este código faz parte de um exemplo maior que ilustra a utilização das funcionalidades Clipboard do DataGridView controlo. Este exemplo faz parte de um exemplo maior disponível em Como: Permitir que os utilizadores copiem múltiplas células para a prancheta a partir do controlo Windows Forms DataGridView.

private void CopyPasteButton_Click(object sender, System.EventArgs e)
{
    if (this.DataGridView1
        .GetCellCount(DataGridViewElementStates.Selected) > 0)
    {
        try
        {
            // Add the selection to the clipboard.
            Clipboard.SetDataObject(
                this.DataGridView1.GetClipboardContent());
            
            // Replace the text box contents with the clipboard text.
            this.TextBox1.Text = Clipboard.GetText();
        }
        catch (System.Runtime.InteropServices.ExternalException)
        {
            this.TextBox1.Text = 
                "The Clipboard could not be accessed. Please try again.";
        }
    }
}

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

    If Me.DataGridView1.GetCellCount( _
        DataGridViewElementStates.Selected) > 0 Then

        Try

            ' Add the selection to the clipboard.
            Clipboard.SetDataObject( _
                Me.DataGridView1.GetClipboardContent())

            ' Replace the text box contents with the clipboard text.
            Me.TextBox1.Text = Clipboard.GetText()

        Catch ex As System.Runtime.InteropServices.ExternalException
            Me.TextBox1.Text = _
                "The Clipboard could not be accessed. Please try again."
        End Try

    End If

End Sub

Observações

Este método é útil para determinar o número de células num determinado estado. Para recuperar o número de células selecionadas, por exemplo, use este método com o DataGridViewElementStates.Selected valor. Isto é normalmente mais eficiente do que usar a propriedade SelectedCells .

Aplica-se a

Ver também