Share via

DataGridViewCheckBoxCell.GetFormattedValue Metoda

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Windows.Forms
Zestaw:
System.Windows.Forms.dll

Pobiera sformatowaną wartość danych komórki.

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

Parametry

value
Object

Wartość, która ma być sformatowana.

rowIndex
Int32

Indeks wiersza nadrzędnego komórki.

cellStyle
DataGridViewCellStyle

Efekt DataGridViewCellStyle dla komórki.

valueTypeConverter
TypeConverter

Skojarzony TypeConverter z typem wartości, który zapewnia niestandardową konwersję do sformatowanego typu wartości lub null jeśli taka konwersja niestandardowa nie jest potrzebna.

formattedValueTypeConverter
TypeConverter

Skojarzony TypeConverter z sformatowanym typem wartości, który zapewnia konwersję niestandardową z typu wartości lub null jeśli taka konwersja niestandardowa nie jest potrzebna.

context
DataGridViewDataErrorContexts

Bitowa kombinacja DataGridViewDataErrorContexts wartości opisujących kontekst, w którym jest wymagana sformatowana wartość.

Zwraca

Object

Wartość danych komórki po zastosowaniu formatowania lub null jeśli komórka nie jest częścią kontrolki DataGridView .

Uwagi

Kontrolka DataGridView wywołuje tę metodę, aby przekonwertować wartość komórki na równoważną wartość wyświetlaną typu wskazanego FormattedValueType przez właściwość. Kontrolka przekazuje wartość komórki do tej metody w parametrze value .

Ta metoda najpierw próbuje przekonwertować value wartość na Boolean wartość lub CheckState przy użyciu TrueValuewłaściwości , FalseValuei IndeterminateValue , jeśli zostały ustawione.

Jeśli konwersja nie powiedzie się, DataGridView.DataError wystąpi zdarzenie. Jeśli dla tego zdarzenia nie ma programu obsługi lub program obsługi ustawia DataGridViewDataErrorEventArgs.ThrowException właściwość na truewartość , zgłaszany jest wyjątek.

Jeśli konwersja zakończyła się pomyślnie lub istnieje procedura obsługi zdarzenia DataError i nie ustawia DataGridViewDataErrorEventArgs.ThrowException właściwości na true, DataGridView.CellFormatting zdarzenie występuje.

Program CellFormatting obsługi zdarzeń może modyfikować zarówno , jak value i cellStyle. Jeśli program obsługi nie ustawi DataGridViewCellFormattingEventArgs.FormattingApplied właściwości na true, jednak ta metoda formatuje value przy użyciu właściwości cellStyle formatowania obiektu. Może to spowodować dodatkowe DataError zdarzenie.

Jeśli formatowanie zakończy się pomyślnie, a wartość parametru context zawiera ClipboardContent wartość, ta metoda zwraca String wersję sformatowanej wartości kopiowania do Schowka. W przeciwnym razie ta metoda zwraca sformatowaną wartość do wyświetlenia w kontrolce DataGridView .

Dotyczy

Zobacz też