DataGridViewCheckBoxCell.GetFormattedValue Metoda

  • Reference

Definice

Obor názvů:
System.Windows.Forms
Sestavení:
System.Windows.Forms.dll

Získá formátovanou hodnotu dat buňky.

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

Parametry

value
Object

Hodnota, která se má formátovat.

rowIndex
Int32

Index nadřazeného řádku buňky.

cellStyle
DataGridViewCellStyle

Hodnota DataGridViewCellStyle pro buňku.

valueTypeConverter
TypeConverter

A TypeConverter přidružené k typu hodnoty, který poskytuje vlastní převod na formátovaný typ hodnoty, nebo null pokud není takový vlastní převod potřeba.

formattedValueTypeConverter
TypeConverter

A TypeConverter přidružené k typ formátované hodnoty, který poskytuje vlastní převod z typu hodnoty, nebo null pokud není takový vlastní převod potřeba.

context
DataGridViewDataErrorContexts

Bitové kombinace DataGridViewDataErrorContexts hodnot popisujících kontext, ve kterém je formátovaná hodnota potřebná.

Návraty

Object

Hodnota dat buňky po použití formátování nebo null pokud buňka není součástí DataGridView ovládacího prvku.

Poznámky

Ovládací DataGridView prvek volá tuto metodu k převodu hodnoty buňky na ekvivalentní zobrazovanou hodnotu typu označeného FormattedValueType vlastností. Ovládací prvek předává hodnotu buňky této metodě v parametru value .

Tato metoda se nejprve pokusí převést value na Boolean hodnotu nebo CheckState pomocí TrueValuevlastností , FalseValuea IndeterminateValue , pokud byly nastaveny.

Pokud převod nebude úspěšný, dojde k DataGridView.DataError události. Pokud pro tuto událost neexistuje žádná obslužná rutina nebo obslužná rutina DataGridViewDataErrorEventArgs.ThrowException nastaví vlastnost na true, vyvolá se výjimka.

Pokud je převod úspěšný nebo existuje obslužná rutina události DataError a nenastaví DataGridViewDataErrorEventArgs.ThrowException vlastnost na , DataGridView.CellFormatting dojde k trueudálosti.

Obslužná rutina CellFormatting události může upravit i cellStylevalue . Pokud obslužná rutina nenastaví DataGridViewCellFormattingEventArgs.FormattingApplied vlastnost na true, ale tato metoda formátuje value pomocí vlastností formátování objektu cellStyle . Výsledkem může být další DataError událost.

Pokud je formátování úspěšné a hodnota parametru contextClipboardContent obsahuje hodnotu, vrátí String tato metoda verzi formátované hodnoty pro kopírování do schránky. V opačném případě vrátí tato metoda formátovanou hodnotu pro zobrazení v ovládacím DataGridView prvku.

Platí pro

Viz také