DataGridViewClipboardCopyMode Wyliczenie

Definicja

Przestrzeń nazw:

System.Windows.Forms

Zestaw:

System.Windows.Forms.dll

Źródło:

DataGridViewClipboardCopyMode.cs

Definiuje stałe wskazujące, czy zawartość jest kopiowana z kontrolki DataGridView do Schowka.

public enum class DataGridViewClipboardCopyMode

public enum DataGridViewClipboardCopyMode

type DataGridViewClipboardCopyMode = 

Public Enum DataGridViewClipboardCopyMode

Dziedziczenie

Object

ValueType

Enum

DataGridViewClipboardCopyMode

Pola

Nazwa	Wartość	Opis
Disable	0	Kopiowanie do Schowka jest wyłączone.
EnableWithAutoHeaderText	1	Wartości tekstowe zaznaczonych komórek można skopiować do Schowka. Tekst nagłówka wiersza lub kolumny jest dołączany do wierszy lub kolumn zawierających zaznaczone komórki tylko wtedy, gdy SelectionMode właściwość jest ustawiona na RowHeaderSelect lub ColumnHeaderSelect a co najmniej jeden nagłówek jest zaznaczony.
EnableWithoutHeaderText	2	Wartości tekstowe zaznaczonych komórek można skopiować do Schowka. Tekst nagłówka nie jest dołączony.
EnableAlwaysIncludeHeaderText	3	Wartości tekstowe zaznaczonych komórek można skopiować do Schowka. Tekst nagłówka jest dołączany do wierszy i kolumn zawierających zaznaczone komórki.

Przykłady

W poniższym przykładzie kodu pokazano, jak włączyć kopiowanie w kontrolce DataGridView . Pełny przykład można znaleźć w temacie How to: Enable Users to Copy Multiple Cells to the Clipboard from the Windows Forms DataGridView Control (Instrukcje: umożliwianie użytkownikom kopiowania wielu komórek do Schowka z kontrolki DataGridView formularzy systemu Windows).

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

Uwagi

Ta wyliczenie jest używana przez ClipboardCopyMode właściwość w celu wskazania, czy użytkownicy mogą kopiować wartości tekstowe zaznaczonych komórek do Schowka oraz czy tekst nagłówka wiersza i kolumny jest uwzględniony.

Zobacz też

• Clipboard
• DataGridView
• ClipboardCopyMode