DataGridViewCheckBoxCell.GetFormattedValue 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
取得儲存格資料的格式化值。
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) 組合,其描述需要此格式化值的內容。
傳回
儲存格的資料在套用格式化之後的值;如果儲存格不是 DataGridView 控制項的一部分,則為 null
。
備註
控制項 DataGridView 會呼叫這個方法,將儲存格值轉換成 屬性所指示 FormattedValueType 之型別的對等顯示值。 控制項會將儲存格值傳遞至 參數中的 value
這個方法。
如果已設定 、 和 屬性,這個方法會先嘗試使用 TrueValue 、 FalseValue 和 IndeterminateValue 屬性轉換成 value
Boolean 或 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 格式化值。
適用於
另請參閱
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應