DataGridView.ClipboardCopyMode Eigenschaft

  • Referenz

Definition

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll
Quelle:
DataGridView.cs
Quelle:
DataGridView.cs
Quelle:
DataGridView.cs

Ruft einen Wert ab, der angibt, ob Zelltextwerte in das Clipboard kopiert werden können und ob Zeilen- und Spaltenheader eingeschlossen werden.

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, set
Public Property ClipboardCopyMode As DataGridViewClipboardCopyMode

Eigenschaftswert

DataGridViewClipboardCopyMode

Einer der DataGridViewClipboardCopyMode-Werte. Der Standardwert ist EnableWithAutoHeaderText.

Attribute
BrowsableAttribute

Ausnahmen

InvalidEnumArgumentException

Der beim Festlegen dieser Eigenschaft angegebene Wert ist kein gültiger DataGridViewClipboardCopyMode-Wert.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Das Kopieren im DataGridView -Steuerelement aktiviert wird. Dieses Beispiel ist Teil eines größeren Beispiels, das unter Vorgehensweise: Aktivieren von Benutzern das Kopieren mehrerer Zellen in die Zwischenablage aus dem Windows Forms DataGridView-Steuerelement verfügbar ist.

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

Hinweise

Das DataGridView Steuerelement kopiert die Textdarstellung jeder ausgewählten Zelle in die Zwischenablage. Dieser Wert ist der Zellenwert, der in eine Zeichenfolge oder bei Bildzellen der Wert der Description -Eigenschaft konvertiert wird.

Werte werden in den Formaten , , UnicodeTextHtmlund CommaSeparatedValue in Textdie Zwischenablage kopiert. Diese Formate sind nützlich, um Inhalte in Anwendungen wie Editor, Microsoft Excel und Microsoft Word einzufügen.

Das DataGridView -Steuerelement kopiert die Zellen im kleinsten Rechteck, das alle ausgewählten Zellen enthält. Zeilen und Spalten, die keine ausgewählten Zellen enthalten, werden in den kopierten Daten nicht dargestellt. Alle nicht ausgewählten Zellen in den verbleibenden Zeilen und Spalten werden durch leere Platzhalter dargestellt. Je nach Kopiermodus und Auswahlmodus können auch Headerwerte für die kopierten Zeilen und Spalten kopiert werden.

Wenn Benutzer Inhalte kopieren, fügt das DataGridView Steuerelement der Zwischenablage ein hinzu DataObject . Dieses Datenobjekt wird von der GetClipboardContent -Methode abgerufen. Sie können diese Methode aufrufen, wenn Sie das Datenobjekt programmgesteuert der Zwischenablage hinzufügen möchten.

Die GetClipboardContent -Methode ruft Werte für einzelne Zellen durch Aufrufen der DataGridViewCell.GetClipboardContent -Methode ab. Sie können eine oder beide Methoden in abgeleiteten Klassen außer Kraft setzen, um das Layout kopierter Zellen anzupassen oder zusätzliche Datenformate zu unterstützen.

Weitere Informationen zu Vorgängen und Datenformaten der Zwischenablage finden Sie in der Clipboard -Klasse.

Gilt für:

Weitere Informationen