DataGridView.ClipboardCopyMode Eigenschap
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee wordt een waarde opgehaald of ingesteld waarmee wordt aangegeven of gebruikers celtekstwaarden kunnen kopiëren naar de Clipboard rij- en kolomkoptekst.
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; }[<System.ComponentModel.Browsable(true)>]
member this.ClipboardCopyMode : System.Windows.Forms.DataGridViewClipboardCopyMode with get, setPublic Property ClipboardCopyMode As DataGridViewClipboardCopyModeWaarde van eigenschap
Een van de DataGridViewClipboardCopyMode waarden. De standaardwaarde is EnableWithAutoHeaderText.
- Kenmerken
Uitzonderingen
De opgegeven waarde bij het instellen van deze eigenschap is geen geldige DataGridViewClipboardCopyMode waarde.
Voorbeelden
In het volgende codevoorbeeld ziet u hoe u kopiëren in het DataGridView besturingselement inschakelt. Dit voorbeeld maakt deel uit van een groter voorbeeld dat beschikbaar is in How to: Enable Users to Copy Multiple Cells to the Klemboard 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
Opmerkingen
Het DataGridView besturingselement kopieert de tekstweergave van elke geselecteerde cel naar het Klembord. Deze waarde is de celwaarde die wordt geconverteerd naar een tekenreeks of, voor afbeeldingscellen, de waarde van de Description eigenschap.
Waarden worden gekopieerd naar het Klembord inText, UnicodeTexten HtmlCommaSeparatedValue indelingen. Deze indelingen zijn handig voor het plakken van inhoud in toepassingen zoals Kladblok, Microsoft Excel en Microsoft Word.
Het DataGridView besturingselement kopieert de cellen in de kleinste rechthoek die alle geselecteerde cellen bevat. Rijen en kolommen die geen geselecteerde cellen bevatten, worden niet weergegeven in de gekopieerde gegevens. Niet-geselecteerde cellen in de resterende rijen en kolommen worden vertegenwoordigd door lege tijdelijke aanduidingen. Afhankelijk van de kopieermodus en de selectiemodus kunnen koptekstwaarden voor de gekopieerde rijen en kolommen ook worden gekopieerd.
Wanneer gebruikers inhoud kopiëren, voegt het DataGridView besturingselement een DataObject toe aan het Klembord. Dit gegevensobject wordt opgehaald uit de GetClipboardContent methode. U kunt deze methode aanroepen wanneer u het gegevensobject programmatisch wilt toevoegen aan het Klembord.
De GetClipboardContent methode haalt waarden voor afzonderlijke cellen op door de methode aan DataGridViewCell.GetClipboardContent te roepen. U kunt een of beide methoden in afgeleide klassen overschrijven om de indeling van gekopieerde cellen aan te passen of om aanvullende gegevensindelingen te ondersteunen.
Zie de Clipboard klasse voor meer informatie over klembordbewerkingen en gegevensindelingen.
