DataGridViewCell.GetClipboardContent Methode

Referenz

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ruft den formatierten Wert der Zelle ab, der nach Clipboard kopiert werden soll.

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

Parameter

rowIndex: Int32

Der auf 0 (null) basierende Index der Zeile, die die Zelle enthält.

firstCell: Boolean

true, um anzuzeigen, dass sich die Zelle in der ersten Spalte des durch die ausgewählten Zellen definierten Bereichs befindet, andernfalls false.

lastCell: Boolean

true, um anzuzeigen, dass die Zelle die letzte Spalte des durch die ausgewählten Zellen definierten Bereichs ist, andernfalls false.

inFirstRow: Boolean

true, um anzuzeigen, dass sich die Zelle in der ersten Zeile des durch die ausgewählten Zellen definierten Bereichs befindet, andernfalls false.

inLastRow: Boolean

true, um anzugeben, dass sich die Zelle in der letzten Zeile des durch die ausgewählten Zellen definierten Bereichs befindet, andernfalls false.

format: String

Die aktuelle Formatzeichenfolge der Zelle.

Gibt zurück

Object

Ein Object, das den Wert der Zelle darstellt, die in die Clipboard kopiert werden soll.

Ausnahmen

ArgumentOutOfRangeException

rowIndex ist kleiner als 0 (null) bzw. größer oder gleich der Anzahl der Zeilen im Steuerelement.

InvalidOperationException

Der Wert der DataGridView-Eigenschaft der Zelle ist null.

- oder -

ColumnIndex ist kleiner als 0 (null). Das bedeutet, dass die Zelle eine Zeilenheaderzelle darstellt.

Exception

Bei der Formatierung sind Fehler aufgetreten. Entweder ist kein Handler für das DataError-Ereignis des DataGridView-Steuerelements vorhanden, oder der Handler hat die ThrowException-Eigenschaft auf true festgelegt. Das Ausnahmeobjekt kann in der Regel in den Typ FormatException umgewandelt werden.

Hinweise

Diese Methode wird von der DataGridView.GetClipboardContent -Methode aufgerufen, um einen Zwischenablage-formatierten Wert abzurufen, der den Zellwert darstellt.

Der Zellwert wird zuerst in seinem Anzeigeformat von der GetEditedFormattedValue -Methode abgerufen. Dadurch kann das DataGridView.CellFormatting Ereignis ausgelöst werden, um den Wert und das Ereignis zu formatieren, wenn die DataGridView.DataError Formatierung nicht erfolgreich ist.

Die positionsbezogenen Parameter dieser Methode geben an, wo sich diese Zelle in der Datentabelle befindet, die die Region darstellt, die durch die ausgewählten Zellen im DataGridView Steuerelement definiert wird. Abhängig von der Position der Zelle werden von dieser Methode möglicherweise zusätzliche Formatierungsinformationen zusammen mit dem anzeigeformatierten Zellenwert zurückgegeben. Beispielsweise enthält das HTML-Format für eine Zelle in der ersten Spalte einer Zeile das Tag, das den Anfang einer Zeile angibt.

Zu den unterstützten Zwischenablageformaten gehören DataFormats.Text, DataFormats.UnicodeText, DataFormats.Htmlund DataFormats.CommaSeparatedValue.

Weitere Informationen finden Sie in den Ausführungen zur Clipboard-Klasse.

Hinweise für Vererber

Überschreiben Sie diese Methode, um benutzerdefinierte Zwischenablagewerte bereitzustellen. Beispielsweise könnten Sie diese Methode überschreiben, um das Kopieren von Werten aus benutzerdefinierten Zelltypen zu unterstützen.

Gilt für:

Freigeben über