DataGridViewImageCell.GetFormattedValue Methode
Definition
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.
Gibt eine Grafik zurück, wie sie in der Zelle angezeigt wird.
protected:
override System::Object ^ GetFormattedValue(System::Object ^ value, int rowIndex, System::Windows::Forms::DataGridViewCellStyle ^ % cellStyle, System::ComponentModel::TypeConverter ^ valueTypeConverter, System::ComponentModel::TypeConverter ^ formattedValueTypeConverter, System::Windows::Forms::DataGridViewDataErrorContexts context);
protected override object GetFormattedValue (object value, int rowIndex, ref System.Windows.Forms.DataGridViewCellStyle cellStyle, System.ComponentModel.TypeConverter valueTypeConverter, System.ComponentModel.TypeConverter formattedValueTypeConverter, System.Windows.Forms.DataGridViewDataErrorContexts context);
protected override object? GetFormattedValue (object? value, int rowIndex, ref System.Windows.Forms.DataGridViewCellStyle cellStyle, System.ComponentModel.TypeConverter? valueTypeConverter, System.ComponentModel.TypeConverter? formattedValueTypeConverter, System.Windows.Forms.DataGridViewDataErrorContexts context);
override this.GetFormattedValue : obj * int * DataGridViewCellStyle * System.ComponentModel.TypeConverter * System.ComponentModel.TypeConverter * System.Windows.Forms.DataGridViewDataErrorContexts -> obj
Protected Overrides Function GetFormattedValue (value As Object, rowIndex As Integer, ByRef cellStyle As DataGridViewCellStyle, valueTypeConverter As TypeConverter, formattedValueTypeConverter As TypeConverter, context As DataGridViewDataErrorContexts) As Object
Parameter
- value
- Object
Der zu formatierende Wert.
- rowIndex
- Int32
Der Index der übergeordneten Zeile der Zelle.
- cellStyle
- DataGridViewCellStyle
Der für die Zelle gültige DataGridViewCellStyle.
- valueTypeConverter
- TypeConverter
Ein dem Werttyp zugeordneter TypeConverter, der eine benutzerdefinierte Konvertierung in den formatierten Werttyp ermöglicht, oder null
, wenn solch eine benutzerdefinierte Konvertierung nicht erforderlich ist.
- formattedValueTypeConverter
- TypeConverter
Ein dem formatierten Werttyp zugeordneter TypeConverter, der eine benutzerdefinierte Konvertierung aus dem Werttyp ermöglicht, oder null
, wenn solch eine benutzerdefinierte Konvertierung nicht erforderlich ist.
- context
- DataGridViewDataErrorContexts
Eine bitweise Kombination von DataGridViewDataErrorContexts-Werten, die den Kontext beschreibt, in dem der formatierte Wert benötigt wird.
Gibt zurück
Ein Objekt, das das formatierte Bild darstellt.
Hinweise
Das DataGridView -Steuerelement ruft diese Methode auf, um einen Zellenwert in einen entsprechenden Anzeigewert des durch die -Eigenschaft angegebenen Typs FormattedValueType zu konvertieren. Das -Steuerelement übergibt den Zellwert an diese Methode im value
-Parameter.
Wenn der context
Parameterwert den ClipboardContent Wert enthält, gibt diese Methode den Wert der Description -Eigenschaft zum Kopieren in die Zwischenablage zurück. Andernfalls tritt das DataGridView.CellFormatting Ereignis auf.
Ein CellFormatting Ereignishandler kann sowohl als cellStyle
auch value
ändern. Wenn der Handler die DataGridViewCellFormattingEventArgs.FormattingApplied -Eigenschaft jedoch nicht auf true
legt, formatiert value
diese Methode mithilfe der Formatierungseigenschaften des cellStyle
-Objekts.
Wenn die Formatierung nicht erfolgreich ist, tritt das DataError Ereignis auf. Wenn kein Handler für dieses Ereignis vorhanden ist oder der Handler die DataGridViewDataErrorEventArgs.ThrowException -Eigenschaft auf true
festlegt, wird eine Ausnahme ausgelöst.
Wenn die Formatierung erfolgreich war und der Typ des formatierten Werts mit dem Wert der FormattedValueType -Eigenschaft übereinstimmt, gibt diese Methode den formatierten Wert zurück. Andernfalls gibt diese Methode eine Standardfehlergrafik im durch die FormattedValueType -Eigenschaft angegebenen Typ zurück.
Gilt für:
Weitere Informationen
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für