DataGridViewClipboardCopyMode Перечисление
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Определяет константы, указывающие, копируется ли содержимое из элемента управления DataGridView в буфер обмена.
public enum class DataGridViewClipboardCopyMode
public enum DataGridViewClipboardCopyMode
type DataGridViewClipboardCopyMode =
Public Enum 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 , чтобы указать, могут ли пользователи копировать текстовые значения выбранных ячеек в буфер обмена и включать ли текст заголовка строки и столбца.