Share via

DataGridViewCheckBoxCell.GetFormattedValue Yöntem

  • Başvuru

Tanım

Ad Alanı:
System.Windows.Forms
Bütünleştirilmiş Kod:
System.Windows.Forms.dll

Hücre verilerinin biçimlendirilmiş değerini alır.

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

Parametreler

value
Object

Biçimlendirilecek değer.

rowIndex
Int32

Hücrenin üst satırının dizini.

cellStyle
DataGridViewCellStyle

Hücrenin DataGridViewCellStyle etkisi.

valueTypeConverter
TypeConverter

TypeConverter Biçimlendirilmiş değer türüne özel dönüştürme sağlayan değer türüyle ilişkili veya null böyle bir özel dönüştürme gerekmiyorsa.

formattedValueTypeConverter
TypeConverter

TypeConverter Değer türünden özel dönüştürme sağlayan biçimlendirilmiş değer türüyle ilişkili veya null böyle bir özel dönüştürme gerekmiyorsa.

context
DataGridViewDataErrorContexts

Biçimlendirilmiş değerin DataGridViewDataErrorContexts gerekli olduğu bağlamı açıklayan değerlerin bit düzeyinde birleşimi.

Döndürülenler

Object

Biçimlendirme uygulandıktan sonra hücre verilerinin değeri veya null hücre bir DataGridView denetimin parçası değilse.

Açıklamalar

Denetim, DataGridView bir hücre değerini özelliği tarafından FormattedValueType belirtilen türde eşdeğer bir görüntüleme değerine dönüştürmek için bu yöntemi çağırır. Denetim, hücre değerini parametresindeki bu yönteme value geçirir.

Bu yöntem, ayarlanmışsa, önce , FalseValueve IndeterminateValue özelliklerini kullanarak TrueValuebir Boolean veya CheckState değerine dönüştürmeyi value dener.

Dönüştürme başarısız olursa olay DataGridView.DataError gerçekleşir. Bu olay için işleyici yoksa veya işleyici özelliğini olarak trueayarlarsaDataGridViewDataErrorEventArgs.ThrowException, bir özel durum oluşturulur.

Dönüştürme başarılı olursa veya olay için DataError bir işleyici varsa ve özelliğini olarak trueDataGridView.CellFormatting ayarlamazsa DataGridViewDataErrorEventArgs.ThrowException olay gerçekleşir.

Olay CellFormatting işleyicisi hem hem de valuecellStyle'i değiştirebilir. Öte yandan işleyici özelliği olarak ayarlamazsaDataGridViewCellFormattingEventArgs.FormattingApplied, bu yöntem nesnesinin biçimlendirme özelliklerini kullanarak biçimlendirmektedir valuecellStyle.true Bu ek bir DataError olayla sonuçlanabilir.

Biçimlendirme başarılı olursa ve context parametre değeri değeri içeriyorsa ClipboardContent , bu yöntem Pano'ya String kopyalamak için biçimlendirilmiş değerin sürümünü döndürür. Aksi takdirde, bu yöntem denetimde DataGridView görüntülenmek üzere biçimlendirilmiş değeri döndürür.

Şunlara uygulanır

Ayrıca bkz.