Share via

DataGridViewImageCell.GetFormattedValue 方法

  • 參考

定義

命名空間:
System.Windows.Forms
組件:
System.Windows.Forms.dll

傳回圖形，與顯示在儲存格中的一樣。

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

參數

value
Object

要格式化的值。

rowIndex
Int32

儲存格的父資料列索引。

cellStyle
DataGridViewCellStyle

DataGridViewCellStyle 對儲存格有作用。

valueTypeConverter
TypeConverter

與實值型別相關的 TypeConverter，此實值型別可提供轉換為格式化實值型別的自訂轉換作業，如果不需要這種自訂轉換，則為 null。

formattedValueTypeConverter
TypeConverter

與格式化實值型別相關的 TypeConverter，此格式化實值型別可提供從實值型別轉換的自訂轉換作業，如果不需要這種自訂轉換，則為 null。

context
DataGridViewDataErrorContexts

DataGridViewDataErrorContexts 值的位元 (Bitwise) 組合，其描述需要此格式化值的內容。

傳回

Object

表示格式化影像的物件。

備註

控制項 DataGridView 會呼叫這個方法，將儲存格值轉換成 屬性所 FormattedValueType 指示之類型的對等顯示值。 控制項會將儲存格值傳遞至 參數中的 value 這個方法。

context如果參數值包含 ClipboardContent 值，這個方法會傳回屬性的值 Description ，以便複製到剪貼簿。 否則，就會 DataGridView.CellFormatting 發生此事件。

CellFormatting事件處理常式可以同時修改 value 和 cellStyle 。 不過，如果處理常式未將 DataGridViewCellFormattingEventArgs.FormattingApplied 屬性設定為 true ，則此方法會使用 物件的格式化屬性 cellStyle 來格式化 value 。

如果格式設定失敗，就會 DataError 發生此事件。 如果這個事件沒有處理常式，或處理常式會將 DataGridViewDataErrorEventArgs.ThrowException 屬性設定為 true ，則會擲回例外狀況。

如果格式化成功，且格式化值的型別符合 屬性的值 FormattedValueType ，這個方法會傳回格式化的值。 否則，這個方法會在 屬性所 FormattedValueType 指示的類型中傳回標準錯誤圖形。

適用於

另請參閱