DataGridView.GetCellCount(DataGridViewElementStates) Método

Definição

Namespace:

System.Windows.Forms

Assembly:

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 de valores DataGridViewElementStates que especifica as células a serem contadas.

Retornos

Int32

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

Exceções

ArgumentException

includeFilter inclui o valor ResizableSet.

Exemplos

O exemplo de código a seguir ilustra como usar esse método para determinar se há células selecionadas em um DataGridView controle. Neste exemplo, se todas as células forem selecionadas, seus valores serão recuperados por meio do GetClipboardContent método e exibidos em um TextBox controle.

Esse código faz parte de um exemplo maior que ilustra o uso dos recursos da Área de Transferência do DataGridView controle. Este exemplo faz parte de um exemplo maior disponível em How to: Enable Users to Copy Multiple Cells to the Clipboard from the Windows Forms DataGridView Control.

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

Comentários

Esse método é útil para determinar o número de células em um estado específico. Para recuperar o número de células selecionadas, por exemplo, use esse método com o DataGridViewElementStates.Selected valor. Normalmente, isso é mais eficiente do que usar a SelectedCells propriedade.

Confira também

• Controle DataGridView (Windows Forms)