Поделиться через


DataGridViewClipboardCopyMode Перечисление

Определение

Определяет константы, указывающие, копируется ли содержимое из элемента управления DataGridView в буфер обмена.

public enum class DataGridViewClipboardCopyMode
public enum DataGridViewClipboardCopyMode
type DataGridViewClipboardCopyMode = 
Public Enum DataGridViewClipboardCopyMode
Наследование
DataGridViewClipboardCopyMode

Поля

Имя Значение Описание
Disable 0

Копирование в буфер обмена отключено.

EnableWithAutoHeaderText 1

Текстовые значения выбранных ячеек можно скопировать в буфер обмена. Текст заголовка строки или столбца включается для строк или столбцов, содержащих выбранные ячейки, только если SelectionMode для свойства задано RowHeaderSelect значение или ColumnHeaderSelect выбран хотя бы один заголовок.

EnableWithoutHeaderText 2

Текстовые значения выбранных ячеек можно скопировать в буфер обмена. Текст заголовка не включен.

EnableAlwaysIncludeHeaderText 3

Текстовые значения выбранных ячеек можно скопировать в буфер обмена. Текст заголовка включается для строк и столбцов, содержащих выбранные ячейки.

Примеры

В следующем примере кода показано, как включить копирование в DataGridView элементе управления. Полный пример см. в разделе "Практическое руководство. Включение пользователями копирования нескольких ячеек в буфер обмена" из элемента управления DataGridView в Windows Forms.

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

Комментарии

Это перечисление используется свойством ClipboardCopyMode , чтобы указать, могут ли пользователи копировать текстовые значения выбранных ячеек в буфер обмена и включать ли текст заголовка строки и столбца.

Применяется к

См. также раздел