DataGridView.ClipboardCopyMode Propiedad

Definición

Obtiene o establece un valor que indica si los usuarios pueden copiar los valores de texto de la celda al Clipboard y si se incluye el texto de los encabezados de fila y columna.Gets or sets a value that indicates whether users can copy cell text values to the Clipboard and whether row and column header text is included.

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; }
member this.ClipboardCopyMode : System.Windows.Forms.DataGridViewClipboardCopyMode with get, set
Public Property ClipboardCopyMode As DataGridViewClipboardCopyMode

Valor de propiedad

Uno de los valores de DataGridViewClipboardCopyMode.One of the DataGridViewClipboardCopyMode values. De manera predeterminada, es EnableWithAutoHeaderText.The default is EnableWithAutoHeaderText.

Atributos

Excepciones

El valor especificado al establecer esta propiedad no es un valor de DataGridViewClipboardCopyMode válido.The specified value when setting this property is not a valid DataGridViewClipboardCopyMode value.

Ejemplos

En el ejemplo de código siguiente se muestra cómo habilitar la copia en el control DataGridView.The following code example demonstrates how to enable copying in the DataGridView control. Este ejemplo forma parte de un ejemplo más grande disponible en [How para: Permita que los usuarios copien varias celdas en el Portapapeles desde el Windows Forms control DataGridView @ no__t-0.This example is part of a larger example available in How to: Enable Users to Copy Multiple Cells to the Clipboard from the 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.";
        }
    }
}
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

Comentarios

El control DataGridView copia la representación de texto de cada celda seleccionada en el portapapeles.The DataGridView control copies the text representation of each selected cell to the Clipboard. Este valor es el valor de celda convertido en una cadena o, para las celdas de la imagen, el valor de la propiedad Description.This value is the cell value converted to a string or, for image cells, the value of the Description property.

Los valores se copian en el Portapapeles con los formatos Text, UnicodeText, Html y CommaSeparatedValue.Values are copied to the Clipboard in Text, UnicodeText, Html, and CommaSeparatedValue formats. Estos formatos son útiles para pegar contenido en aplicaciones como el Bloc de notas, Microsoft Excel y Microsoft WordMicrosoft Word.These formats are useful for pasting content into applications such as Notepad, Microsoft Excel, and Microsoft WordMicrosoft Word.

El control DataGridView copia las celdas contenidas en el rectángulo más pequeño que incluye todas las celdas seleccionadas.The DataGridView control copies the cells contained in the smallest rectangle that includes all selected cells. Las filas y columnas que no contienen ninguna celda seleccionada no se representan en los datos copiados.Rows and columns that do not contain any selected cells are not represented in the copied data. Las celdas no seleccionadas en las filas y columnas restantes se representan mediante marcadores de posición en blanco.Any unselected cells in the remaining rows and columns are represented by blank placeholders. Dependiendo del modo de copia y del modo de selección, también se pueden copiar los valores de encabezado de las filas y columnas copiadas.Depending on the copy mode and the selection mode, header values for the copied rows and columns may be copied, as well.

Cuando los usuarios copian contenido, el control DataGridView agrega un DataObject al portapapeles.When users copy content, the DataGridView control adds a DataObject to the Clipboard. Este objeto de datos se recupera del método GetClipboardContent.This data object is retrieved from the GetClipboardContent method. Puede llamar a este método cuando desee agregar mediante programación el objeto de datos al portapapeles.You can call this method when you want to programmatically add the data object to the Clipboard.

El método GetClipboardContent recupera los valores de las celdas individuales llamando al método DataGridViewCell.GetClipboardContent.The GetClipboardContent method retrieves values for individual cells by calling the DataGridViewCell.GetClipboardContent method. Puede invalidar cualquiera de estos métodos o ambos en clases derivadas para personalizar el diseño de las celdas copiadas o para admitir formatos de datos adicionales.You can override either or both of these methods in derived classes to customize the layout of copied cells or to support additional data formats.

Para obtener más información sobre las operaciones del portapapeles y los formatos de datos, vea la clase Clipboard.For more information about Clipboard operations and data formats, see the Clipboard class.

Se aplica a

Consulte también: