DataGridViewImageCell.GetFormattedValue Méthode

  • Référence

Définition

Espace de noms:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Retourne une image comme elle devrait être affichée dans la cellule.

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

Paramètres

value
Object

Valeur à mettre en forme.

rowIndex
Int32

Index de la ligne parente de la cellule.

cellStyle
DataGridViewCellStyle

DataGridViewCellStyle en vigueur pour la cellule.

valueTypeConverter
TypeConverter

TypeConverter associé au type valeur qui fournit la conversion personnalisée en type valeur mise en forme, ou null si une telle conversion personnalisée n'est pas nécessaire.

formattedValueTypeConverter
TypeConverter

TypeConverter associé au type valeur mise en forme qui fournit la conversion personnalisée du type valeur, ou null si une telle conversion personnalisée n'est pas nécessaire.

context
DataGridViewDataErrorContexts

Combinaison d'opérations de bits des valeurs DataGridViewDataErrorContexts indiquant le contexte dans lequel la valeur mise en forme est nécessaire.

Retours

Object

Objet qui représente l'image mise en forme.

Remarques

Le DataGridView contrôle appelle cette méthode pour convertir une valeur de cellule en une valeur d’affichage équivalente du type indiqué par la FormattedValueType propriété . Le contrôle transmet la valeur de cellule à cette méthode dans le value paramètre .

Si la valeur du context paramètre inclut la ClipboardContent valeur, cette méthode retourne la valeur de la propriété pour la Description copie dans le Presse-papiers. Sinon, l’événement DataGridView.CellFormatting se produit.

Un CellFormatting gestionnaire d’événements peut modifier à la fois value et cellStyle. Si le gestionnaire ne définit pas la propriété sur DataGridViewCellFormattingEventArgs.FormattingAppliedtrue, toutefois, cette méthode met en forme value à l’aide des propriétés de mise en forme de l’objet cellStyle .

Si la mise en forme échoue, l’événement DataError se produit. S’il n’existe aucun gestionnaire pour cet événement ou si le gestionnaire définit la DataGridViewDataErrorEventArgs.ThrowException propriété sur true, une exception est levée.

Si la mise en forme réussit et que le type de la valeur mise en forme correspond à la valeur de la FormattedValueType propriété, cette méthode renvoie la valeur mise en forme. Sinon, cette méthode retourne un graphique d’erreur standard dans le type indiqué par la FormattedValueType propriété .

S’applique à

Voir aussi