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

Определение

Определяет константы, которые указывают, должно ли копироваться содержимое из элемента DataGridView в буфер обмена.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
Наследование
DataGridViewClipboardCopyMode

Поля

Disable 0

Копирование в буфер обмена отключено.Copying to the Clipboard is disabled.

EnableAlwaysIncludeHeaderText 3

Текстовые значения выбранных ячеек могут быть скопированы в буфер обмена.The text values of selected cells can be copied to the Clipboard. Для строк и столбцов, содержащих выбранные ячейки, включается текст заголовка.Header text is included for rows and columns that contain selected cells.

EnableWithAutoHeaderText 1

Текстовые значения выбранных ячеек могут быть скопированы в буфер обмена.The text values of selected cells can be copied to the Clipboard. Текст заголовков строк или столбцов включается для строк и столбцов, содержащих выбранные ячейки, только в том случае, если свойство SelectionMode имеет значение RowHeaderSelect или ColumnHeaderSelect и при этом выбран по меньшей мере один заголовок.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

Текстовые значения выбранных ячеек могут быть скопированы в буфер обмена.The text values of selected cells can be copied to the Clipboard. Текст заголовка не включается.Header text is not included.

Примеры

В следующем примере кода показано, как включить копирование в DataGridView элементе управления.The following code example demonstrates how to enable copying in the DataGridView control. Полный пример см. в разделе как разрешить пользователям копировать несколько ячеек в буфер обмена из элемента управления Windows Forms DataGridView.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

Комментарии

Это перечисление используется ClipboardCopyMode свойством для указания, могут ли пользователи копировать текстовые значения выбранных ячеек в буфер обмена и включать ли текст заголовка строки и столбца.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.

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

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