Share via

DataGridViewImageCell.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, описывающая контекст, в котором требуется форматированное значение.

Возвращаемое значение

Object

Объект, представляющий форматированное изображение.

Комментарии

Элемент DataGridView управления вызывает этот метод для преобразования значения ячейки в эквивалентное отображаемое значение типа, указанного свойством FormattedValueType . Элемент управления передает значение ячейки этому методу в параметре value .

context Если значение параметра включает ClipboardContent значение , этот метод возвращает значение Description свойства для копирования в буфер обмена. В противном случае возникает DataGridView.CellFormatting событие .

CellFormatting Обработчик событий может изменять как , так value и cellStyle. Однако если обработчик не задает свойству DataGridViewCellFormattingEventArgs.FormattingAppliedtrueзначение , этот метод форматирует value с помощью свойств cellStyle форматирования объекта .

Если форматирование не удается, DataError возникает событие . Если обработчик для этого события отсутствует или обработчик задает DataGridViewDataErrorEventArgs.ThrowException для свойства trueзначение , создается исключение.

Если форматирование выполнено успешно и тип отформатированного значения совпадает со значением FormattedValueType свойства , этот метод возвращает форматируемое значение. В противном случае этот метод возвращает стандартный рисунок ошибки в типе, указанном свойством FormattedValueType .

Применяется к

См. также раздел