DataGridViewCell.GetClipboardContent Metoda
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í.
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
true
označuje, že buňka je v prvním sloupci oblasti definované vybranými buňkami; v opačném případě . false
- lastCell
- Boolean
true
označuje, že buňka je posledním sloupcem oblasti definované vybranými buňkami; v opačném případě . false
- inFirstRow
- Boolean
true
označuje, že buňka je v prvním řádku oblasti definované vybranými buňkami; v opačném případě . false
- inLastRow
- Boolean
true
označ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
Představuje Object hodnotu buňky, která se má zkopírovat do objektu Clipboard.
Výjimky
rowIndex
je menší než 0 nebo větší než nebo roven počtu řádků v ovládacím prvku.
Hodnota vlastnosti buňky DataGridView je null
.
-nebo-
ColumnIndex je menší než 0, což znamená, že buňka je buňka záhlaví řádku.
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.