Este artigo foi traduzido por máquina. Para visualizar o arquivo em inglês, marque a caixa de seleção Inglês. Você também pode exibir o texto Em inglês em uma janela pop-up, movendo o ponteiro do mouse sobre o texto.
Tradução
Inglês
Esta documentação foi arquivada e não está sendo atualizada.

Propriedade DataGridView.ClipboardCopyMode

Obtém ou define um valor que indica se os usuários podem copiar valores de texto da célula para o Clipboard e se o texto do cabeçalho de linha e coluna está incluído.

Namespace:  System.Windows.Forms
Assembly:  System.Windows.Forms (em System.Windows.Forms.dll)

[BrowsableAttribute(true)]
public DataGridViewClipboardCopyMode ClipboardCopyMode { get; set; }

ExceçãoCondição
InvalidEnumArgumentException

O valor especificado quando a definição dessa propriedade não é válido DataGridViewClipboardCopyMode valor.

O DataGridView controle copia a representação de texto de cada célula selecionada para a área de transferência. Esse valor é o valor da célula convertido para uma seqüência de caracteres ou, para células de imagem, o valor de Description propriedade.

Valores são copiados para a área de transferência em Text, UnicodeText, Html, e CommaSeparatedValue formatos. Esses formatos são úteis para colar o conteúdo em aplicativos como o bloco de notas, Microsoft Excel, e Microsoft Word.

O DataGridView cópias de controle células contidas no menor retângulo que inclui todas as células selecionadas. Linhas e colunas que contêm as células selecionadas não são representadas nos dados copiados. As células não selecionadas nas linhas e colunas restantes são representadas por espaços reservados de em branco. Dependendo do modo de cópia e o modo de seleção, os valores de cabeçalho para as colunas e linhas copiadas podem ser copiados, também.

Quando os usuários copiem o conteúdo, o DataGridView controle adiciona um DataObject para a área de transferência. O objeto de dados é recuperado da GetClipboardContent método. Você pode chamar esse método quando você deseja adicionar programaticamente o objeto de dados na área de transferência.

O GetClipboardContent método recupera os valores de células individuais chamando o DataGridViewCell.GetClipboardContent método. Você pode substituir um ou ambos os métodos em classes derivadas para personalizar o layout das células copiadas ou para oferecer suporte a formatos de dados adicionais.

Para obter mais informações sobre as operações da área de transferência e formatos de dados, consulte o Clipboard classe.

O exemplo de código a seguir demonstra como habilitar copiando o DataGridView de controle. Este exemplo é parte de um exemplo maior disponível em Como: Permitir que os usuários copiar várias células para a área de transferência do Windows Forms DataGridView Control.


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.";
        }
    }
}


.NET Framework

Com suporte em: 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Com suporte em: 4, 3.5 SP1

Windows 7, Windows Vista SP1 ou posterior, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core não compatível), Windows Server 2008 R2 (Server Core não compatível com SP1 ou posterior), Windows Server 2003 SP2

O .NET Framework não oferece suporte a todas as versões de cada plataforma. Para obter uma lista das versões com suporte, consulte Requisitos de sistema do .NET Framework.
Mostrar: