DataGridViewCheckBoxCell.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.
Obtém o valor formatado dos dados da 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
O valor dos dados da célula após a aplicação da formatação ou null
se a célula não fizer parte de um controle DataGridView.
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 .
Esse método primeiro tenta converter value
em um Boolean valor ou CheckState usando as TrueValuepropriedades , FalseValuee IndeterminateValue se elas tiverem sido definidas.
Se a conversão não for bem-sucedida, o DataGridView.DataError evento ocorrerá. Se não houver nenhum manipulador para esse evento ou o manipulador definir a DataGridViewDataErrorEventArgs.ThrowException propriedade true
como , uma exceção será gerada.
Se a conversão for bem-sucedida ou houver um manipulador para o DataError evento e ela não definir a DataGridViewDataErrorEventArgs.ThrowException propriedade como true
, o DataGridView.CellFormatting evento ocorrerá.
Um CellFormatting manipulador de eventos pode modificar e cellStyle
value
. No entanto, se o manipulador não definir a DataGridViewCellFormattingEventArgs.FormattingApplied propriedade true
como , esse método value
formatará usando as propriedades de formatação do cellStyle
objeto . Isso pode resultar em um evento adicional DataError .
Se a formatação for bem-sucedida e o valor do context
parâmetro incluir o ClipboardContent valor, esse método retornará a String versão do valor formatado para cópia para a Área de Transferência. Caso contrário, esse método retornará o valor formatado para exibição no DataGridView controle .