DataGridViewImageCell.GetFormattedValue Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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
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 value
cellStyle
. 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à .