Dieser Artikel wurde manuell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen. |
Übersetzung
Original
|
DataGridView.ClipboardCopyMode-Eigenschaft
Ruft einen Wert ab, der angibt, ob Zelltextwerte in das Clipboard kopiert werden können und ob Zeilen- und Spaltenheader eingeschlossen werden.
Assembly: System.Windows.Forms (in System.Windows.Forms.dll)
[BrowsableAttribute(true)] public DataGridViewClipboardCopyMode ClipboardCopyMode { get; set; }
Eigenschaftswert
Typ: System.Windows.Forms.DataGridViewClipboardCopyModeEiner der DataGridViewClipboardCopyMode-Werte. Der Standardwert ist EnableWithAutoHeaderText.
| Ausnahme | Bedingung |
|---|---|
| InvalidEnumArgumentException |
Der angegebene Wert beim Festlegen dieser Eigenschaft ist kein gültiger DataGridViewClipboardCopyMode-Wert. |
Das DataGridView-Steuerelement kopiert die Textdarstellung der einzelnen ausgewählten Zellen in die Zwischenablage. Dieser Wert ist der in eine Zeichenfolge konvertierte Zellwert oder, für Bildzellen, der Wert der Description-Eigenschaft.
Werte werden in den Formaten Text, UnicodeText, Html und CommaSeparatedValue in die Zwischenablage kopiert. Diese Formate eignen sich zum Einfügen von Inhalten in Anwendungen wie Editor, Microsoft Excel und Microsoft Word.
Das DataGridView-Steuerelement kopiert die Zellen, die im kleinsten Rechteck enthalten sind, das alle ausgewählten Zellen umfasst. Zeilen und Spalten, die keine ausgewählten Zellen enthalten, werden in den kopierten Daten nicht dargestellt. Alle nicht ausgewählten Zellen in den übrigen Zeilen und Spalten werden durch leere Platzhalter dargestellt. Je nach Kopiermodus und Auswahlmodus können Headerwerte für die kopierten Zeilen und Spalten ebenfalls kopiert werden.
Wenn Benutzer Inhalt kopieren, fügt das DataGridView-Steuerelement der Zwischenablage ein DataObject hinzu. Dieses Datenobjekt wird von der GetClipboardContent-Methode abgerufen. Sie können diese Methode aufrufen, wenn Sie der Zwischenablage das Datenobjekt programmgesteuert hinzufügen möchten.
Die GetClipboardContent-Methode ruft Werte für einzelne Zellen ab, indem die DataGridViewCell.GetClipboardContent-Methode aufgerufen wird. Sie können jeweils eine oder beide dieser Methoden in abgeleiteten Klassen überschreiben, um das Layout der kopierten Zellen anzupassen oder zusätzliche Datenformate zu unterstützen.
Weitere Informationen zu Zwischenablagevorgängen und Datenformaten finden Sie in der Clipboard-Klasse.
Im folgenden Beispiel wird veranschaulicht, wie das Kopieren im DataGridView-Steuerelement aktiviert wird. Dieses Beispiel ist Teil eines umfangreicheren Beispiels in Gewusst wie: Festlegen, dass mehrere Zellen aus dem DataGridView-Steuerelement in Windows Forms in die Zwischenablage kopiert werden können.
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."; } } }
Windows 7, Windows Vista SP1 oder höher, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core wird nicht unterstützt), Windows Server 2008 R2 (Server Core wird mit SP1 oder höher unterstützt), Windows Server 2003 SP2
.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.
