DataGridViewImageCell.GetFormattedValue Methode

  • Referenz

Definition

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

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

Object

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 cellStyleauch value ändern. Wenn der Handler die DataGridViewCellFormattingEventArgs.FormattingApplied -Eigenschaft jedoch nicht auf truelegt, 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 truefestlegt, 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