DataGridViewCell.GetClipboardContent Metoda

Reference

Definice

Obor názvů:: System.Windows.Forms

Sestavení:: System.Windows.Forms.dll

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í.

Načte formátovanou hodnotu buňky, která se má zkopírovat do Clipboard.

protected:
 virtual System::Object ^ GetClipboardContent(int rowIndex, bool firstCell, bool lastCell, bool inFirstRow, bool inLastRow, System::String ^ format);

protected virtual object GetClipboardContent (int rowIndex, bool firstCell, bool lastCell, bool inFirstRow, bool inLastRow, string format);

protected virtual object? GetClipboardContent (int rowIndex, bool firstCell, bool lastCell, bool inFirstRow, bool inLastRow, string format);

abstract member GetClipboardContent : int * bool * bool * bool * bool * string -> obj
override this.GetClipboardContent : int * bool * bool * bool * bool * string -> obj

Protected Overridable Function GetClipboardContent (rowIndex As Integer, firstCell As Boolean, lastCell As Boolean, inFirstRow As Boolean, inLastRow As Boolean, format As String) As Object

Parametry

rowIndex: Int32

Index řádku obsahujícího buňku založený na nule.

firstCell: Boolean

trueoznačuje, že buňka je v prvním sloupci oblasti definované vybranými buňkami; v opačném případě . false

lastCell: Boolean

trueoznačuje, že buňka je posledním sloupcem oblasti definované vybranými buňkami; v opačném případě . false

inFirstRow: Boolean

trueoznačuje, že buňka je v prvním řádku oblasti definované vybranými buňkami; v opačném případě . false

inLastRow: Boolean

trueoznačuje, že buňka je v posledním řádku oblasti definované vybranými buňkami; v opačném případě . false

format: String

Aktuální formátovací řetězec buňky.

Návraty

Object

Představuje Object hodnotu buňky, která se má zkopírovat do objektu Clipboard.

Výjimky

ArgumentOutOfRangeException

rowIndex je menší než 0 nebo větší než nebo roven počtu řádků v ovládacím prvku.

InvalidOperationException

Hodnota vlastnosti buňky DataGridView je null.

-nebo-

ColumnIndex je menší než 0, což znamená, že buňka je buňka záhlaví řádku.

Exception

Formátování se nezdařilo a buď neexistuje žádná obslužná rutina pro DataError událost DataGridView ovládacího prvku, nebo obslužná rutina nastavila ThrowException vlastnost na true. Objekt výjimky lze obvykle přetypovat na typ FormatException.

Poznámky

Tato metoda je volána metodou DataGridView.GetClipboardContent pro načtení hodnoty ve formátu schránky, která představuje hodnotu buňky.

Hodnota buňky se nejprve načte ve formátu zobrazení z GetEditedFormattedValue metody. To může vyvolat událost pro DataGridView.CellFormatting formátování hodnoty a událost, DataGridView.DataError pokud formátování není úspěšné.

Parametry související s polohou této metody označují umístění této buňky v tabulce dat představující oblast definovanou vybranými buňkami v ovládacím DataGridView prvku. V závislosti na umístění buňky mohou být touto metodou vráceny další informace o formátování spolu s hodnotou buňky ve formátu zobrazení. Například formát HTML pro buňku v prvním sloupci řádku bude obsahovat značku, která označuje začátek řádku.

Mezi podporované formáty schránky patří DataFormats.Text, DataFormats.UnicodeText, DataFormats.Htmla DataFormats.CommaSeparatedValue.

Další informace najdete ve Clipboard třídě.

Poznámky pro dědice

Přepište tuto metodu a zadejte přizpůsobené hodnoty schránky. Tuto metodu můžete například přepsat tak, aby podporovala kopírování hodnot z vlastních typů buněk.

Platí pro