DataGridView.ClipboardCopyMode Propriedade
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Obtém ou define um valor que indica se os usuários podem copiar valores de texto da célula para a Clipboard e se o texto de cabeçalho de linha e de coluna é incluído.
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, setPublic Property ClipboardCopyMode As DataGridViewClipboardCopyModeUm dos valores de DataGridViewClipboardCopyMode. O padrão é EnableWithAutoHeaderText.
- Atributos
O valor especificado ao definir essa propriedade não é um valor DataGridViewClipboardCopyMode válido.
O exemplo de código a seguir demonstra como habilitar a cópia no DataGridView controle . Este exemplo faz parte de um exemplo maior disponível em Como habilitar os usuários a copiar várias células para a área de transferência do controle 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
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 em uma cadeia de caracteres ou, para células de imagem, o valor da Description propriedade.
Os valores são copiados para a Área de Transferência nos Textformatos , UnicodeTextHtml, e CommaSeparatedValue . Esses formatos são úteis para colar conteúdo em aplicativos como Bloco de Notas, Microsoft Excel e Microsoft Word.
O DataGridView controle copia as células contidas no menor retângulo que inclui todas as células selecionadas. Linhas e colunas que não contêm células selecionadas não são representadas nos dados copiados. Todas as células não selecionadas nas linhas e colunas restantes são representadas por espaços reservados em branco. Dependendo do modo de cópia e do modo de seleção, os valores de cabeçalho para as linhas e colunas copiadas também podem ser copiados.
Quando os usuários copiam conteúdo, o DataGridView controle adiciona um DataObject à Área de Transferência. Esse objeto de dados é recuperado do GetClipboardContent método . Você pode chamar esse método quando quiser adicionar programaticamente o objeto de dados à Área de Transferência.
O GetClipboardContent método recupera valores para 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 dar suporte a formatos de dados adicionais.
Para obter mais informações sobre operações de área de transferência e formatos de dados, consulte a Clipboard classe .
| Produto | Versões |
|---|---|
| .NET Framework | 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
| Windows Desktop | 3.0, 3.1, 5, 6, 7, 8, 9, 10 |
Comentários do .NET
O .NET é um projeto código aberto. Selecione um link para fornecer comentários: