DataGridViewClipboardCopyMode Énumération
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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
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.