DataGridViewCheckBoxCell.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 控制項的一部分，則為 null。

備註

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

如果已設定 、 和 屬性，這個方法會先嘗試使用 TrueValue 、 FalseValue 和 IndeterminateValue 屬性轉換成 valueBoolean 或 CheckState 值。

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

如果轉換成功或事件有處理常式 DataError ，而且它不會將 DataGridViewDataErrorEventArgs.ThrowException 屬性設定為 true ，就會 DataGridView.CellFormatting 發生此事件。

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

如果格式化成功，且 context 參數值包含 ClipboardContent 值，這個方法會 String 傳回格式化值的版本，以便複製到剪貼簿。 否則，這個方法會傳回控制項中顯示的 DataGridView 格式化值。

適用於

另請參閱