DataGridViewClipboardCopyMode Énumération

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Source:

DataGridViewClipboardCopyMode.cs

Définit des constantes qui indiquent si le contenu est copié à partir d’un contrôle DataGridView dans le Presse-papiers.

public enum class DataGridViewClipboardCopyMode

public enum DataGridViewClipboardCopyMode

type DataGridViewClipboardCopyMode = 

Public Enum DataGridViewClipboardCopyMode

Héritage

Object

ValueType

Enum

DataGridViewClipboardCopyMode

Champs

Nom	Valeur	Description
Disable	0	La copie dans le Presse-papiers est désactivée.
EnableWithAutoHeaderText	1	Les valeurs de texte des cellules sélectionnées peuvent être copiées dans le Presse-papiers. 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 SelectionMode propriété est définie RowHeaderSelect ou ColumnHeaderSelect qu’au moins un en-tête est sélectionné.
EnableWithoutHeaderText	2	Les valeurs de texte des cellules sélectionnées peuvent être copiées dans le Presse-papiers. Le texte d’en-tête n’est pas inclus.
EnableAlwaysIncludeHeaderText	3	Les valeurs de texte des cellules sélectionnées peuvent être copiées dans le Presse-papiers. Le texte d’en-tête est inclus pour les lignes et les colonnes qui contiennent des cellules sélectionnées.

Exemples

L’exemple de code suivant montre comment activer la copie dans le DataGridView contrôle. Pour obtenir l’exemple complet, consultez Guide pratique pour permettre aux utilisateurs de copier plusieurs cellules dans le Presse-papiers à partir du contrôle DataGridView Windows Forms.

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 la ClipboardCopyMode propriété pour indiquer si les utilisateurs peuvent copier les valeurs de 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.

Voir aussi

• Clipboard
• DataGridView
• ClipboardCopyMode