DataGridViewClipboardCopyMode Enumeration

Definition

Definiert Konstanten, die angeben, ob Inhalt aus einem DataGridView-Steuerelement in die Zwischenablage kopiert wird.Defines constants that indicate whether content is copied from a DataGridView control to the Clipboard.

public enum class DataGridViewClipboardCopyMode
public enum DataGridViewClipboardCopyMode
type DataGridViewClipboardCopyMode = 
Public Enum DataGridViewClipboardCopyMode
Vererbung
DataGridViewClipboardCopyMode

Felder

Disable 0

Kopieren in die Zwischenablage ist deaktiviert.Copying to the Clipboard is disabled.

EnableAlwaysIncludeHeaderText 3

Die Textwerte ausgewählter Zellen können in die Zwischenablage kopiert werden.The text values of selected cells can be copied to the Clipboard. Headertext ist für Zeilen und Spalten eingeschlossen, in denen ausgewählte Zellen enthalten sind.Header text is included for rows and columns that contain selected cells.

EnableWithAutoHeaderText 1

Die Textwerte ausgewählter Zellen können in die Zwischenablage kopiert werden.The text values of selected cells can be copied to the Clipboard. Der Headertext von Zeilen und Spalten wird nur für Zeilen und Spalten eingeschlossen, die ausgewählte Zellen enthalten, wenn die SelectionMode-Eigenschaft auf RowHeaderSelect oder ColumnHeaderSelect festgelegt ist und mindestens ein Header ausgewählt ist.Row or column header text is included for rows or columns that contain selected cells only when the SelectionMode property is set to RowHeaderSelect or ColumnHeaderSelect and at least one header is selected.

EnableWithoutHeaderText 2

Die Textwerte ausgewählter Zellen können in die Zwischenablage kopiert werden.The text values of selected cells can be copied to the Clipboard. Headertext ist nicht eingeschlossen.Header text is not included.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie das Kopieren im DataGridView -Steuerelement aktiviert wird.The following code example demonstrates how to enable copying in the DataGridView control. Das vollständige Beispiel finden Sie unter Vorgehensweise: Ermöglicht es Benutzern, mehrere Zellen aus dem Windows Forms DataGridView-SteuerElement in die Zwischenablage zu kopieren.For the complete example, see How to: Enable Users to Copy Multiple Cells to the Clipboard 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

Hinweise

Diese Enumeration wird von der ClipboardCopyMode -Eigenschaft verwendet, um anzugeben, ob Benutzer die Textwerte ausgewählter Zellen in die Zwischenablage kopieren können und ob Zeilen-und Spaltenheader Text eingeschlossen ist.This enumeration is used by the ClipboardCopyMode property to indicate whether users can copy the text values of selected cells to the Clipboard and whether row and column header text is included.

Gilt für:

Siehe auch