DataGridView.ClipboardCopyMode Vlastnost
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Získá nebo nastaví hodnotu, která označuje, zda uživatelé mohou kopírovat textové hodnoty buňky do Clipboard a zda je zahrnut text řádku a sloupce.
public:
property System::Windows::Forms::DataGridViewClipboardCopyMode ClipboardCopyMode { System::Windows::Forms::DataGridViewClipboardCopyMode get(); void set(System::Windows::Forms::DataGridViewClipboardCopyMode value); };[System.ComponentModel.Browsable(true)]
public System.Windows.Forms.DataGridViewClipboardCopyMode ClipboardCopyMode { get; set; }[<System.ComponentModel.Browsable(true)>]
member this.ClipboardCopyMode : System.Windows.Forms.DataGridViewClipboardCopyMode with get, setPublic Property ClipboardCopyMode As DataGridViewClipboardCopyModeHodnota vlastnosti
Jedna z DataGridViewClipboardCopyMode hodnot. Výchozí hodnota je EnableWithAutoHeaderText.
- Atributy
Výjimky
Zadaná hodnota při nastavení této vlastnosti není platná DataGridViewClipboardCopyMode hodnota.
Příklady
Následující příklad kódu ukazuje, jak povolit kopírování v ovládacím DataGridView prvku. Tento příklad je součástí většího příkladu, který je k dispozici v části Postupy: Povolení kopírování více buněk do schránky z ovládacího prvku Windows Forms DataGridView.
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
Poznámky
Ovládací DataGridView prvek zkopíruje textovou reprezentaci každé vybrané buňky do schránky. Tato hodnota je hodnota buňky převedená na řetězec nebo pro buňky obrázku hodnotu Description vlastnosti.
Hodnoty se zkopírují do schránky ve schránce v TextUnicodeTextHtml, a CommaSeparatedValue formátech. Tyto formáty jsou užitečné pro vkládání obsahu do aplikací, jako jsou Poznámkový blok, Microsoft Excel a Microsoft Word.
Ovládací DataGridView prvek zkopíruje buňky obsažené v nejmenším obdélníku, který obsahuje všechny vybrané buňky. Řádky a sloupce, které neobsahují žádné vybrané buňky, nejsou reprezentovány ve zkopírovaných datech. Všechny nevybrané buňky ve zbývajících řádcích a sloupcích jsou reprezentovány prázdnými zástupnými symboly. V závislosti na režimu kopírování a režimu výběru se můžou zkopírovat i hodnoty záhlaví pro zkopírované řádky a sloupce.
Když uživatelé kopírují obsah, DataGridView ovládací prvek přidá DataObject do schránky. Tento datový objekt se načte z GetClipboardContent metody. Tuto metodu můžete volat, když chcete datový objekt přidat do schránky prostřednictvím kódu programu.
Metoda GetClipboardContent načte hodnoty pro jednotlivé buňky voláním DataGridViewCell.GetClipboardContent metody. V odvozených třídách můžete přepsat buď nebo obě tyto metody, abyste přizpůsobili rozložení zkopírovaných buněk nebo podporovali další formáty dat.
Další informace o operacích schránky a datových formátech najdete v Clipboard této třídě.
