DataGridViewClipboardCopyMode Énumération

Définition

Définit des constantes qui indiquent si le contenu est copié d'un contrôle DataGridView vers le Presse-papiers.Defines constants that indicate whether content is copied from a DataGridView control to the Clipboard.

public enum class DataGridViewClipboardCopyMode
public enum DataGridViewClipboardCopyMode
type DataGridViewClipboardCopyMode = 
Public Enum DataGridViewClipboardCopyMode
Héritage
DataGridViewClipboardCopyMode

Champs

Disable 0

La copie vers le Presse-papiers est désactivée.Copying to the Clipboard is disabled.

EnableAlwaysIncludeHeaderText 3

Les valeurs de texte de cellules sélectionnées peuvent être copiées vers le Presse-papiers.The text values of selected cells can be copied to the Clipboard. Le texte d'en-tête est inclus pour les lignes et les colonnes qui contiennent des cellules sélectionnées.Header text is included for rows and columns that contain selected cells.

EnableWithAutoHeaderText 1

Les valeurs de texte de cellules sélectionnées peuvent être copiées vers le Presse-papiers.The text values of selected cells can be copied to the Clipboard. Le texte d'en-tête de ligne ou de colonne est inclus pour les lignes ou les colonnes qui contiennent des cellules sélectionnées uniquement lorsque la propriété SelectionMode a la valeur RowHeaderSelect ou ColumnHeaderSelect et qu'au moins un en-tête est sélectionné.Row or column header text is included for rows or columns that contain selected cells only when the SelectionMode property is set to RowHeaderSelect or ColumnHeaderSelect and at least one header is selected.

EnableWithoutHeaderText 2

Les valeurs de texte de cellules sélectionnées peuvent être copiées vers le Presse-papiers.The text values of selected cells can be copied to the Clipboard. Le texte d'en-tête n'est pas inclus.Header text is not included.

Exemples

L’exemple de code suivant montre comment activer la copie dans DataGridView le contrôle.The following code example demonstrates how to enable copying in the DataGridView control. Pour obtenir un exemple complet, consultez Comment : Permet aux utilisateurs de copier plusieurs cellules dans le presse-papiers à partirdu contrôle DataGridView Windows Forms.For the complete example, see 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

Remarques

Cette énumération est utilisée par ClipboardCopyMode la propriété pour indiquer si les utilisateurs peuvent copier les valeurs texte des cellules sélectionnées dans le presse-papiers et si le texte d’en-tête de ligne et de colonne est inclus.This enumeration is used by the ClipboardCopyMode property to indicate whether users can copy the text values of selected cells to the Clipboard and whether row and column header text is included.

S’applique à

Voir aussi