DataGridViewImageCell.GetFormattedValue(Object, Int32, DataGridViewCellStyle, TypeConverter, TypeConverter, DataGridViewDataErrorContexts) DataGridViewImageCell.GetFormattedValue(Object, Int32, DataGridViewCellStyle, TypeConverter, TypeConverter, DataGridViewDataErrorContexts) DataGridViewImageCell.GetFormattedValue(Object, Int32, DataGridViewCellStyle, TypeConverter, TypeConverter, DataGridViewDataErrorContexts) DataGridViewImageCell.GetFormattedValue(Object, Int32, DataGridViewCellStyle, TypeConverter, TypeConverter, DataGridViewDataErrorContexts) Method

Definición

Devuelve un gráfico tal como se mostraría en la celda.Returns a graphic as it would be displayed in the cell.

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);
override this.GetFormattedValue : obj * int *  * 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 Object Object Object

Valor al que se debe dar formato.The value to be formatted.

rowIndex
Int32 Int32 Int32 Int32

Índice de la fila primaria de la celda.The index of the cell's parent row.

valueTypeConverter
TypeConverter TypeConverter TypeConverter TypeConverter

TypeConverter asociado al tipo de valor que proporciona la conversión personalizada al tipo de valor con formato; o bien, null si no es necesaria esa conversión personalizada.A TypeConverter associated with the value type that provides custom conversion to the formatted value type, or null if no such custom conversion is needed.

formattedValueTypeConverter
TypeConverter TypeConverter TypeConverter TypeConverter

TypeConverter asociado al tipo de valor con formato que proporciona la conversión personalizada desde el tipo de valor; o bien, null si no es necesaria esa conversión personalizada.A TypeConverter associated with the formatted value type that provides custom conversion from the value type, or null if no such custom conversion is needed.

context
DataGridViewDataErrorContexts DataGridViewDataErrorContexts DataGridViewDataErrorContexts DataGridViewDataErrorContexts

Una combinación bit a bit de valores DataGridViewDataErrorContexts que describen el contexto en el que es necesario el valor con formato.A bitwise combination of DataGridViewDataErrorContexts values describing the context in which the formatted value is needed.

Devoluciones

Objeto que representa la imagen con formato.An object that represents the formatted image.

Comentarios

El DataGridView control llama a este método para convertir un valor de celda en un valor de presentación equivalente del tipo indicado por la FormattedValueType propiedad.The DataGridView control calls this method to convert a cell value into an equivalent display value of the type indicated by the FormattedValueType property. El control pasa el valor de la celda a este método en el value parámetro.The control passes the cell value to this method in the value parameter.

Si el context incluye el valor del parámetro el ClipboardContent valor, este método devuelve el valor de la Description propiedad para copiar al Portapapeles.If the context parameter value includes the ClipboardContent value, this method returns the value of the Description property for copying to the Clipboard. En caso contrario, el DataGridView.CellFormatting se produce el evento.Otherwise, the DataGridView.CellFormatting event occurs.

Un CellFormatting controlador de eventos puede modificar tanto value y cellStyle.A CellFormatting event handler can modify both value and cellStyle. Si no establece el controlador de la DataGridViewCellFormattingEventArgs.FormattingApplied propiedad true, sin embargo, da formato a este método value mediante las propiedades de formato de la cellStyle objeto.If the handler does not set the DataGridViewCellFormattingEventArgs.FormattingApplied property to true, however, this method formats value using the formatting properties of the cellStyle object.

Si no lo consigue, el formato del DataError se produce el evento.If formatting is unsuccessful, the DataError event occurs. Si no hay ningún controlador para este evento o el controlador se establece la DataGridViewDataErrorEventArgs.ThrowException propiedad true, se produce una excepción.If there is no handler for this event or the handler sets the DataGridViewDataErrorEventArgs.ThrowException property to true, an exception is thrown.

Si el formato es correcta y el tipo de valor con formato coincide con el valor de la FormattedValueType propiedad, este método devuelve el valor con formato.If formatting is successful and the type of the formatted value matches the value of the FormattedValueType property, this method returns the formatted value. En caso contrario, este método devuelve un gráfico de error estándar en el tipo indicado por la FormattedValueType propiedad.Otherwise, this method returns a standard error graphic in the type indicated by the FormattedValueType property.

Se aplica a

Consulte también: