DataGridViewClipboardCopyMode Énumération

  • Référence

Définition

Espace de noms:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Définit des constantes qui indiquent si le contenu est copié d'un contrôle DataGridView vers le Presse-papiers.

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

Champs

Disable 0

La copie vers le Presse-papiers est désactivée.
EnableAlwaysIncludeHeaderText 3

Les valeurs de texte de cellules sélectionnées peuvent être copiées vers le Presse-papiers. Le texte d'en-tête est inclus pour les lignes et les colonnes qui contiennent des cellules sélectionnées.
EnableWithAutoHeaderText 1

Les valeurs de texte de cellules sélectionnées peuvent être copiées vers 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 propriété SelectionMode a la valeur RowHeaderSelect ou ColumnHeaderSelect et qu'au moins un en-tête est sélectionné.
EnableWithoutHeaderText 2

Les valeurs de texte de cellules sélectionnées peuvent être copiées vers le Presse-papiers. Le texte d'en-tête n'est pas inclus.

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.

S’applique à

Voir aussi