DataGridView.ClipboardCopyMode Vlastnost

  • Reference

Definice

Obor názvů:
System.Windows.Forms
Sestavení:
System.Windows.Forms.dll

Získá nebo nastaví hodnotu, která označuje, zda uživatelé mohou kopírovat textové hodnoty buňky a Clipboard zda je zahrnut text záhlaví řádků a sloupců.

public:
 property System::Windows::Forms::DataGridViewClipboardCopyMode ClipboardCopyMode { System::Windows::Forms::DataGridViewClipboardCopyMode get(); void set(System::Windows::Forms::DataGridViewClipboardCopyMode value); };
[System.ComponentModel.Browsable(true)]
public System.Windows.Forms.DataGridViewClipboardCopyMode ClipboardCopyMode { get; set; }
[<System.ComponentModel.Browsable(true)>]
member this.ClipboardCopyMode : System.Windows.Forms.DataGridViewClipboardCopyMode with get, set
Public Property ClipboardCopyMode As DataGridViewClipboardCopyMode

Hodnota vlastnosti

DataGridViewClipboardCopyMode

Jedna z DataGridViewClipboardCopyMode hodnot. Výchozí formát je EnableWithAutoHeaderText.

Atributy
BrowsableAttribute

Výjimky

InvalidEnumArgumentException

Zadaná hodnota při nastavení této vlastnosti není platná DataGridViewClipboardCopyMode hodnota.

Příklady

Následující příklad kódu ukazuje, jak povolit kopírování v ovládacím DataGridView prvku. Tento příklad je součástí většího příkladu, který je k dispozici v části Postupy: Povolení uživatelům kopírovat více buněk do schránky z ovládacího prvku model Windows Forms DataGridView.

private void Form1_Load(object sender, System.EventArgs e)
{
    // Initialize the DataGridView control.
    this.DataGridView1.ColumnCount = 5;
    this.DataGridView1.Rows.Add(new string[] { "A", "B", "C", "D", "E" });
    this.DataGridView1.Rows.Add(new string[] { "F", "G", "H", "I", "J" });
    this.DataGridView1.Rows.Add(new string[] { "K", "L", "M", "N", "O" });
    this.DataGridView1.Rows.Add(new string[] { "P", "Q", "R", "S", "T" });
    this.DataGridView1.Rows.Add(new string[] { "U", "V", "W", "X", "Y" });
    this.DataGridView1.AutoResizeColumns();
    this.DataGridView1.ClipboardCopyMode = 
        DataGridViewClipboardCopyMode.EnableWithoutHeaderText;
}

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 Form1_Load(ByVal sender As Object, _
    ByVal e As System.EventArgs) Handles Me.Load

    ' Initialize the DataGridView control.
    Me.DataGridView1.ColumnCount = 5
    Me.DataGridView1.Rows.Add(New String() {"A", "B", "C", "D", "E"})
    Me.DataGridView1.Rows.Add(New String() {"F", "G", "H", "I", "J"})
    Me.DataGridView1.Rows.Add(New String() {"K", "L", "M", "N", "O"})
    Me.DataGridView1.Rows.Add(New String() {"P", "Q", "R", "S", "T"})
    Me.DataGridView1.Rows.Add(New String() {"U", "V", "W", "X", "Y"})
    Me.DataGridView1.AutoResizeColumns()
    Me.DataGridView1.ClipboardCopyMode = _
        DataGridViewClipboardCopyMode.EnableWithoutHeaderText

End Sub

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

Ovládací DataGridView prvek zkopíruje textovou reprezentaci každé vybrané buňky do schránky. Tato hodnota je hodnota buňky převedená na řetězec nebo v případě buněk obrázku hodnotu Description vlastnosti.

Hodnoty se zkopírují do schránky ve Textformátech , HtmlUnicodeText, aCommaSeparatedValue. Tyto formáty jsou užitečné pro vkládání obsahu do aplikací, jako je Poznámkový blok, Microsoft Excel a Microsoft Word.

Ovládací DataGridView prvek zkopíruje buňky obsažené v nejmenším obdélníku, který obsahuje všechny vybrané buňky. Řádky a sloupce, které neobsahují žádné vybrané buňky, nejsou ve zkopírovaných datech reprezentovány. Všechny nevybrané buňky ve zbývajících řádcích a sloupcích jsou reprezentovány prázdnými zástupnými symboly. V závislosti na režimu kopírování a režimu výběru mohou být zkopírovány také hodnoty záhlaví pro zkopírované řádky a sloupce.

Když uživatelé kopírují obsah, DataGridView ovládací prvek přidá DataObject do schránky objekt . Tento datový objekt se načte z GetClipboardContent metody. Tuto metodu můžete volat, když chcete datový objekt přidat do schránky prostřednictvím kódu programu.

Metoda GetClipboardContent načte hodnoty pro jednotlivé buňky voláním DataGridViewCell.GetClipboardContent metody . V odvozených třídách můžete přepsat jednu nebo obě tyto metody a přizpůsobit tak rozložení zkopírovaných buněk nebo podporovat další formáty dat.

Další informace o operacích schránky a datových formátech najdete ve Clipboard třídě .

Platí pro

Viz také