DataGridView.GetCellCount(DataGridViewElementStates) Metoda

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Získá počet buněk, které splňují zadaný filtr.

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

Parametry

includeFilter

DataGridViewElementStates

Bitové kombinace DataGridViewElementStates hodnot určujících buňky, které se mají spočítat.

Návraty

Int32

Počet buněk, které odpovídají parametru includeFilter .

Výjimky

ArgumentException

includeFilter obsahuje hodnotu ResizableSet.

Příklady

Následující příklad kódu ukazuje, jak tuto metodu použít k určení, zda jsou v ovládacím DataGridView prvku vybrány nějaké buňky. Pokud jsou v tomto příkladu vybrány nějaké buňky, jejich hodnoty se načtou metodou GetClipboardContent a zobrazí se v ovládacím TextBox prvku.

Tento kód je součástí většího příkladu znázorňující použití funkcí DataGridView schránky ovládacího prvku. Tento příklad je součástí většího příkladu, který je k dispozici v části Postupy: Povolení kopírování více buněk do schránky z ovládacího prvku model 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

Poznámky

Tato metoda je užitečná k určení počtu buněk v určitém stavu. Pokud chcete načíst počet vybraných buněk, použijte například tuto metodu DataGridViewElementStates.Selected s hodnotou. Obvykle je to efektivnější než použití SelectedCells vlastnosti.

Viz také

• DataGridView – ovládací prvek (Windows Forms)