Bagikan melalui

DataGridViewCheckBoxCell.GetFormattedValue Metode

  • Referensi

Definisi

Ruang nama:
System.Windows.Forms
Rakitan:
System.Windows.Forms.dll

Mendapatkan nilai data sel yang diformat.

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

Nilai yang akan diformat.

rowIndex
Int32

Indeks baris induk sel.

cellStyle
DataGridViewCellStyle

Efek DataGridViewCellStyle untuk sel.

valueTypeConverter
TypeConverter

Yang TypeConverter terkait dengan jenis nilai yang menyediakan konversi kustom ke jenis nilai yang diformat, atau null jika tidak ada konversi kustom seperti itu yang diperlukan.

formattedValueTypeConverter
TypeConverter

Yang TypeConverter terkait dengan jenis nilai yang diformat yang menyediakan konversi kustom dari jenis nilai, atau null jika tidak ada konversi kustom seperti itu yang diperlukan.

context
DataGridViewDataErrorContexts

Kombinasi DataGridViewDataErrorContexts nilai bitwise yang menjelaskan konteks di mana nilai yang diformat diperlukan.

Mengembalikan

Object

Nilai data sel setelah pemformatan diterapkan atau null jika sel bukan bagian DataGridView dari kontrol.

Keterangan

Kontrol DataGridView memanggil metode ini untuk mengonversi nilai sel menjadi nilai tampilan yang setara dari jenis yang ditunjukkan FormattedValueType oleh properti . Kontrol meneruskan nilai sel ke metode ini dalam value parameter .

Metode ini pertama-tama mencoba mengonversi value ke Boolean nilai atau CheckState menggunakan TrueValueproperti , FalseValue, dan IndeterminateValue jika telah ditetapkan.

Jika konversi tidak berhasil, peristiwa akan DataGridView.DataError terjadi. Jika tidak ada handler untuk kejadian ini atau handler mengatur DataGridViewDataErrorEventArgs.ThrowException properti ke true, pengecualian akan dilemparkan.

Jika konversi berhasil atau ada handler untuk DataError peristiwa dan tidak mengatur DataGridViewDataErrorEventArgs.ThrowException properti ke true, DataGridView.CellFormatting peristiwa terjadi.

Penanganan CellFormatting aktivitas dapat memodifikasi dan valuecellStyle. Namun, jika handler tidak mengatur DataGridViewCellFormattingEventArgs.FormattingApplied properti ke true, metode ini memformat value menggunakan properti cellStyle pemformatan objek. Ini dapat mengakibatkan peristiwa tambahan DataError .

Jika pemformatan berhasil dan context nilai parameter menyertakan ClipboardContent nilai , metode ini mengembalikan String versi nilai yang diformat untuk disalin ke Clipboard. Jika tidak, metode ini mengembalikan nilai yang diformat untuk ditampilkan dalam DataGridView kontrol.

Berlaku untuk

Lihat juga