DataGridViewImageCell.GetFormattedValue Método

  • Referência

Definição

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Retorna um elemento gráfico como ela seria exibido na célula.

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

Parâmetros

value
Object

O valor a ser formatado.

rowIndex
Int32

O índice da linha pai da célula.

cellStyle
DataGridViewCellStyle

O DataGridViewCellStyle em vigor para a célula.

valueTypeConverter
TypeConverter

Um TypeConverter associado ao tipo de valor que fornece conversão personalizada para o tipo de valor formatado ou null se nenhuma conversão personalizada for necessária.

formattedValueTypeConverter
TypeConverter

Um TypeConverter associado ao tipo de valor formatado que fornece conversão personalizada para o tipo de valor ou null se nenhuma conversão personalizada for necessária.

context
DataGridViewDataErrorContexts

Uma combinação bit a bit dos valores DataGridViewDataErrorContexts que descreve o contexto no qual o valor formatado é necessário.

Retornos

Object

Um objeto que representa a imagem formatada.

Comentários

O DataGridView controle chama esse método para converter um valor de célula em um valor de exibição equivalente do tipo indicado pela FormattedValueType propriedade . O controle passa o valor da célula para esse método no value parâmetro .

Se o valor do context parâmetro incluir o ClipboardContent valor, esse método retornará o valor da Description propriedade para copiar para a Área de Transferência. Caso contrário, o DataGridView.CellFormatting evento ocorrerá.

Um CellFormatting manipulador de eventos pode modificar e cellStylevalue . Se o manipulador não definir a DataGridViewCellFormattingEventArgs.FormattingApplied propriedade como true, no entanto, esse método formata value usando as propriedades de formatação do cellStyle objeto.

Se a formatação não for bem-sucedida, o DataError evento ocorrerá. Se não houver nenhum manipulador para esse evento ou o manipulador definir a DataGridViewDataErrorEventArgs.ThrowException propriedade como true, uma exceção será gerada.

Se a formatação for bem-sucedida e o tipo do valor formatado corresponder ao valor da FormattedValueType propriedade , esse método retornará o valor formatado. Caso contrário, esse método retornará um gráfico de erro padrão no tipo indicado pela FormattedValueType propriedade .

Aplica-se a

Confira também