DataGridViewImageCell.GetFormattedValue Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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
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 cellStyle
value
. 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
Comentários
https://aka.ms/ContentUserFeedback.
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja:Submeter e ver comentários