DataGridViewCell.GetClipboardContent Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Haalt de opgemaakte waarde van de cel op om naar de Clipboardcel te kopiëren.
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
Parameters
- rowIndex
- Int32
De op nul gebaseerde index van de rij die de cel bevat.
- firstCell
- Boolean
true om aan te geven dat de cel zich in de eerste kolom van het gebied bevindt dat is gedefinieerd door de geselecteerde cellen; anders, false.
- lastCell
- Boolean
true om aan te geven dat de cel de laatste kolom is van het gebied dat door de geselecteerde cellen is gedefinieerd; anders, false.
- inFirstRow
- Boolean
true om aan te geven dat de cel zich in de eerste rij van het gebied bevindt dat is gedefinieerd door de geselecteerde cellen; anders, false.
- inLastRow
- Boolean
true om aan te geven dat de cel zich in de laatste rij van het gebied bevindt dat is gedefinieerd door de geselecteerde cellen; anders, false.
- format
- String
De huidige notatietekenreeks van de cel.
Retouren
Een Object die de waarde van de cel aangeeft die naar de Clipboardcel moet worden gekopieerd.
Uitzonderingen
rowIndex is kleiner dan 0 of groter dan of gelijk aan het aantal rijen in het besturingselement.
De waarde van de eigenschap van de cel DataGridView is null.
– of –
ColumnIndex is kleiner dan 0, waarmee wordt aangegeven dat de cel een rijkopcel is.
De opmaak is mislukt en er is geen handler voor de gebeurtenis van het DataErrorDataGridView besturingselement of de handler stelt de ThrowException eigenschap in op true. Het uitzonderingsobject kan doorgaans worden gecast naar type FormatException.
Opmerkingen
Deze methode wordt aangeroepen door de DataGridView.GetClipboardContent methode om een met Klembord opgemaakte waarde op te halen die de celwaarde vertegenwoordigt.
De celwaarde wordt eerst opgehaald in de weergave-indeling van de GetEditedFormattedValue methode. Hierdoor kan de gebeurtenis worden gegenereerd om de DataGridView.CellFormatting waarde en de gebeurtenis op te maken als de DataGridView.DataError opmaak mislukt.
De positiegerelateerde parameters van deze methode geven aan waar deze cel zich bevindt in de tabel met gegevens die het gebied vertegenwoordigen dat is gedefinieerd door de geselecteerde cellen in het DataGridView besturingselement. Afhankelijk van de positie van de cel, kunnen aanvullende opmaakgegevens worden geretourneerd door deze methode, samen met de waarde van de weergegeven cel. De HTML-indeling voor een cel in de eerste kolom van een rij bevat bijvoorbeeld de tag die het begin van een rij aangeeft.
De ondersteunde Klembord-indelingen zijn onder andere DataFormats.Text, DataFormats.UnicodeText, DataFormats.Htmlen DataFormats.CommaSeparatedValue.
Zie de Clipboard klas voor meer informatie.
Notities voor overnemers
Overschrijf deze methode om aangepaste Klembordwaarden op te geven. U kunt deze methode bijvoorbeeld overschrijven om het kopiëren van waarden uit aangepaste celtypen te ondersteunen.