DataGridViewImageCell.GetFormattedValue Metodo

  • Riferimento

Definizione

Spazio dei nomi:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Restituisce un'immagine così come verrebbe visualizzata nella cella.

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

Parametri

value
Object

Valore da formattare.

rowIndex
Int32

Indice della riga padre della cella.

cellStyle
DataGridViewCellStyle

DataGridViewCellStyle attivo per la cella.

valueTypeConverter
TypeConverter

Classe TypeConverter associata al tipo di valore che fornisce la conversione personalizzata nel tipo di valore formattato oppure null se non è necessaria alcuna conversione personalizzata.

formattedValueTypeConverter
TypeConverter

Classe TypeConverter associata al tipo di valore formattato che fornisce la conversione personalizzata dal tipo di valore oppure null se non è necessaria alcuna conversione personalizzata.

context
DataGridViewDataErrorContexts

Combinazione bit per bit dei valori di DataGridViewDataErrorContexts che descrive il contesto in cui è necessario il valore formattato.

Restituisce

Object

Oggetto che rappresenta l'immagine formattata.

Commenti

Il DataGridView controllo chiama questo metodo per convertire un valore di cella in un valore di visualizzazione equivalente del tipo indicato dalla FormattedValueType proprietà . Il controllo passa il valore della cella a questo metodo nel value parametro .

Se il valore del context parametro include il ClipboardContent valore, questo metodo restituisce il valore della proprietà per la Description copia negli Appunti. In caso contrario, si verifica l'evento DataGridView.CellFormatting .

Un CellFormatting gestore eventi può modificare sia che valuecellStyle. Se il gestore non imposta la DataGridViewCellFormattingEventArgs.FormattingApplied proprietà su true, tuttavia, questo metodo formatta value utilizzando le proprietà di formattazione dell'oggetto cellStyle .

Se la formattazione ha esito negativo, l'evento DataError si verifica. Se non è presente alcun gestore per questo evento o il gestore imposta la DataGridViewDataErrorEventArgs.ThrowException proprietà su true, viene generata un'eccezione.

Se la formattazione ha esito positivo e il tipo del valore formattato corrisponde al valore della FormattedValueType proprietà, questo metodo restituisce il valore formattato. In caso contrario, questo metodo restituisce un elemento grafico di errore standard nel tipo indicato dalla FormattedValueType proprietà .

Si applica a

Vedi anche