FdcFieldValueChangingContext<T> class

Mutable context supplied before a proposed field value is committed.

Use valueOf to inspect related fields and setValueOf to stage additional field changes that should accompany the primary value change.

Implementers

Constructors

FdcFieldValueChangingContext({BuildContext? buildContext, required FdcDataSet dataSet, required FdcFieldEventHost host, required String fieldName, FdcFieldDef? field, required int rowIndex, int? columnIndex, Object? row, Object? column, T? oldValue, T? newValue, Object? oldRawValue, Object? newRawValue, Object? valueOf(String fieldName)?})
Creates a FdcFieldValueChangingContext.

Properties

additionalValueSnapshot Map<String, Object?>
Immutable snapshot of related field updates staged with setValueOf.
no setter
buildContext BuildContext?
Flutter context of the editor or grid surface that emitted the event.
final
column Object?
Host-specific column object when the event originated from a grid.
final
columnIndex int?
Zero-based column index in the current grid layout.
final
dataSet FdcDataSet
Dataset that owns the field and current edit state.
final
field FdcFieldDef?
Resolved field metadata when available.
final
fieldName String
Name of the dataset field involved in the event.
final
hashCode int
The hash code for this object.
no setterinherited
host FdcFieldEventHost
UI surface that emitted the event.
final
newRawValue Object?
New unformatted source value.
final
newValue → T?
Proposed logical value before the change decision is applied.
final
oldRawValue Object?
Previous unformatted source value.
final
oldValue → T?
Logical field value before the proposed or completed change.
final
row Object?
Host-specific row object when the event originated from a grid.
final
rowIndex int
Zero-based row index in the current view.
final
runtimeType Type
A representation of the runtime type of the object.
no setterinherited

Methods

accept() FdcFieldValueChangeResult<T>
Accepts the proposed value without replacement.
cancel([String? message]) FdcFieldValueChangeResult<T>
Cancels the current operation or edit state.
noSuchMethod(Invocation invocation) → dynamic
Invoked when a nonexistent method or property is accessed.
inherited
replaceValue(T? value) FdcFieldValueChangeResult<T>
Accepts the change and commits value instead of the proposed value.
setValueOf<V>(String fieldName, V? value) → void
Adds or replaces the pending value for fieldName.
toString() String
A string representation of this object.
inherited
tryValueOf<V>(String fieldName) → V?
Returns the value of fieldName, or null when the field is unavailable.
valueOf<V>(String fieldName) → V?
Returns the typed value of fieldName, throwing if the field is unknown.

Operators

operator ==(Object other) bool
The equality operator.
inherited