DataGridViewImageCell.GetFormattedValue Metoda

Odwołanie

Definicja

Przestrzeń nazw:: System.Windows.Forms

Zestaw:: System.Windows.Forms.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Zwraca grafikę, która będzie wyświetlana w komórce.

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 * 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

Wartość do sformatowania.

rowIndex: Int32

Indeks wiersza nadrzędnego komórki.

cellStyle: DataGridViewCellStyle

Efekt DataGridViewCellStyle dla komórki.

valueTypeConverter: TypeConverter

Skojarzony TypeConverter z typem wartości, który zapewnia konwersję niestandardową na typ sformatowanej wartości lub null jeśli taka konwersja niestandardowa nie jest wymagana.

formattedValueTypeConverter: TypeConverter

Skojarzony TypeConverter z sformatowanym typem wartości, który zapewnia konwersję niestandardową z typu wartości lub null jeśli taka konwersja niestandardowa nie jest wymagana.

context: DataGridViewDataErrorContexts

Bitowa kombinacja DataGridViewDataErrorContexts wartości opisujących kontekst, w którym jest wymagana sformatowana wartość.

Zwraca

Object

Obiekt reprezentujący sformatowany obraz.

Uwagi

Kontrolka DataGridView wywołuje tę metodę, aby przekonwertować wartość komórki na równoważną wartość wyświetlaną typu wskazanego FormattedValueType przez właściwość. Kontrolka przekazuje wartość komórki do tej metody w parametrze value .

Jeśli wartość parametru context ClipboardContent zawiera wartość, ta metoda zwraca wartość Description właściwości kopiowania do Schowka. DataGridView.CellFormatting W przeciwnym razie wystąpi zdarzenie.

Program CellFormatting obsługi zdarzeń może modyfikować zarówno elementy , jak value i cellStyle. Jeśli program obsługi nie ustawi DataGridViewCellFormattingEventArgs.FormattingApplied właściwości na true, jednak ta metoda formatuje value przy użyciu właściwości cellStyle formatowania obiektu.

Jeśli formatowanie nie powiedzie się, DataError wystąpi zdarzenie. Jeśli dla tego zdarzenia nie ma procedury obsługi lub program obsługi ustawia DataGridViewDataErrorEventArgs.ThrowException właściwość na truewartość , zgłaszany jest wyjątek.

Jeśli formatowanie zakończy się pomyślnie, a typ sformatowanej wartości jest zgodny z wartością FormattedValueType właściwości, ta metoda zwraca sformatowaną wartość. W przeciwnym razie ta metoda zwraca standardową grafikę o błędzie w typie FormattedValueType wskazanym przez właściwość .

Dotyczy