fdc library
High-performance RAD data components for Flutter data applications.
This is the primary Community entrypoint. It exposes datasets, data-aware editors, grids, filtering, sorting, searching, aggregates, export support, localization, focus management, and shared theme APIs through one stable import:
import 'package:flutter_data_components/fdc.dart';
A typical application defines an FdcDataSet, binds an FdcGrid or editor
controls to it, and optionally uses an adapter when data must be loaded or
applied through an external source. Lightweight entrypoints are also
available for app configuration, editors, and export-only integrations.
Classes
- FdcActionColumn
- Grid column that renders standardized row-level actions.
- FdcApp
- App/subtree-level settings scope for Flutter Data Components.
-
FdcBadgeColumn<
T> - Grid column that renders field values as compact badge labels.
- FdcBadgeValue
- Value object for badge editors when text, color, icon, or text style varies per row.
- FdcBinaryExportPayload
- Binary payload returned by writers such as PDF or spreadsheet exporters.
-
FdcBooleanColumn<
T> - Grid column for boolean fields with checkbox or switch-style interaction.
- FdcBooleanEdit
- Data-aware editor for boolean dataset fields.
- FdcBooleanField
- Boolean dataset field definition.
- FdcCellContext
- Runtime cell context passed to FdcCustomColumn.cellBuilder.
- FdcChangeSet
- Immutable collection of pending dataset insert, update, and delete actions.
- FdcChangeSetEntry
- One inserted, updated, or deleted record in an FdcChangeSet.
- FdcColumnFilterConfig
- Per-column configuration for grid-managed header filtering.
- FdcColumnSummary
- Per-column summary configuration.
-
FdcColumnValueChangedContext<
T> - Grid-column context supplied after the primary edited value has been written locally.
-
FdcColumnValueChangingContext<
T> - Grid-column context supplied before an edited value is written to the dataset.
-
FdcComboColumn<
T> - Grid column for fields whose values come from a predefined option set.
-
FdcComboEdit<
T> - Data-aware selection editor backed by a predefined set of options.
- FdcComboSearchOptions
- Search configuration for combo editors and combo grid columns.
- FdcCommonTranslations
- Common FDC text shared by multiple component families.
- FdcConfirmationDialog
- Modal yes/no confirmation dialog using FDC translations and button styling.
- FdcCounterStyle
- Visual style for text-length counters used by editors and grid cells.
-
FdcCustomColumn<
T> - Field-bound custom column.
- FdcDataAdapter
-
Contract between an
FdcDataSetand an external data source. - FdcDataAdapterCapabilities
- Declares which query and aggregate operations an adapter can execute.
- FdcDataAdapterFilter
- Source-level filter descriptor passed to a data adapter.
- FdcDataAdapterSort
- Source-level ordering descriptor passed to a data adapter.
- FdcDataAggregateItem
- One aggregate expression requested from an adapter.
- FdcDataAggregateKey
- Stable key identifying one aggregate expression and its result value.
- FdcDataAggregateRequest
- Adapter aggregate request over the full effective query result set.
- FdcDataAggregateResult
- Values returned for an FdcDataAggregateRequest.
- FdcDataApplyError
- Structured error for a record rejected during adapter apply.
- FdcDataApplyFailure
- Failed adapter apply result containing structured row-level errors.
- FdcDataApplyResult
-
Result returned by
IFdcDataAdapter.applyUpdates(). - FdcDataApplySuccess
- Successful adapter apply result.
- FdcDataLoadRequest
- Query request sent by a dataset to an adapter.
- FdcDataLoadResult
- Rows and paging metadata returned by an adapter load.
- FdcDataPagingOptions
- Configures adapter-backed dataset paging.
- FdcDataRecordKey
- Stable dataset/business key used for adapter-aware row selection.
- FdcDataSet
- Flutter-friendly in-memory dataset with typed schema metadata, edit lifecycle management, validation, filtering, sorting and cached updates.
- FdcDataSetAggregatesApi
- Public aggregate facade for FdcDataSet.
- FdcDataSetBookmark
- An immutable position marker for a record in an FdcDataSet.
- FdcDataSetBookmarksApi
- Public bookmark facade for FdcDataSet.
- FdcDataSetError
- Read-only dataset error entry emitted by the dataset error pipeline.
- FdcDataSetErrorMessagesApi
- Read-only message view over the current FdcDataSet errors.
- FdcDataSetErrorsApi
- Public error-message facade for FdcDataSet.
- FdcDataSetFilter
- Describes one field predicate in the active dataset filter.
- FdcDataSetFilterContext
- Runtime context used while preparing and evaluating dataset filters.
- FdcDataSetFilters
- Dataset-level filter API.
- FdcDataSetOperationOptions
- Tunables for long-running dataset operations.
- FdcDataSetPagingApi
- Public paging facade for FdcDataSet.
- FdcDataSetSearchApi
- Dataset-level global search API.
- FdcDataSetSearchState
- Immutable dataset search state.
- FdcDataSetSelectionApi
- Public row-selection facade for FdcDataSet.
- FdcDataSetSort
- Describes one field ordering rule in the active dataset sort.
- FdcDataSetSorts
- Dataset-level sort API.
- FdcDataSetWork
- Lightweight observable work state owned by a dataset.
- FdcDataSetWorkInfo
- Immutable snapshot for a dataset work lifecycle transition.
-
FdcDateColumn<
T> - Grid column specialized for date-only dataset fields.
- FdcDateEdit
- Data-aware editor for date-only dataset fields.
- FdcDateField
- Dataset field metadata for date-only values.
-
FdcDateTimeColumn<
T> - Grid column for date-and-time fields with locale-aware display and editing.
- FdcDateTimeEdit
- Data-aware editor for full date-and-time dataset fields.
- FdcDateTimeField
- Date-and-time dataset field definition storing full DateTime values.
- FdcDecimal
- Fixed-scale decimal value used by decimal field runtime values.
-
FdcDecimalColumn<
T> - Grid column for fixed-precision decimal fields with numeric formatting and editing.
- FdcDecimalEdit
- Data-aware editor for decimal dataset fields.
- FdcDecimalField
- Decimal field metadata.
- FdcDefaultFormatResolver
- Default FDC format resolver.
- FdcDefaultTranslationResolver
- Default built-in FDC translation resolver.
- FdcDialogTranslations
- Dialog text resources.
- FdcEditorComboPopupStyle
- Visual styling for combo-editor popup surfaces, search UI, and option rows.
- FdcEditorControlsStyle
- Visual styling for non-text editor controls such as boolean and combo UI.
- FdcEditorInputStyle
- Visual styling for text-like FDC editor inputs.
- FdcEditorTheme
- Optional Flutter ThemeExtension bridge for FDC editors.
- FdcEditorThemeData
- Complete visual theme for standalone FDC editors.
- FdcEditorThemes
- Built-in editor theme presets supplied by FDC.
- FdcErrorIndicatorMarker
- Small top-left error marker shared by grid cells and standalone editors.
- FdcErrorIndicatorMarkerStyle
- Visual styling for the compact triangular validation marker.
- FdcErrorIndicatorOptions
- Configures how a component presents validation and data-entry errors.
- FdcExportColumn
- Maps one source field to its exported identity and presentation metadata.
- FdcExporter
- Coordinates FDC exports by resolving rows, columns and format writers.
- FdcExportFormat
- Export output format descriptor.
- FdcExportFormatStyle
- Base type for format-specific visual export styles.
- FdcExportOptions
- Cross-format options that control row selection, column selection and text serialization behavior for FDC exports.
- FdcExportPayload
-
Serialized content produced by an
FdcExportWriter. - FdcExportRegistry
- Global registry of export writers available to FDC.
- FdcExportResult
- Completed export together with its format metadata and serialized payload.
- FdcExportStyle
- App- or subtree-level default styles resolved by export writers.
- FdcExportWriter
- Contract implemented by built-in and extension export format writers.
- FdcExportWriterContext
-
Immutable export request passed to an
FdcExportWriter. - FdcExportWriterOptions
- Marker base type for format-specific writer configuration.
- FdcField
- Runtime accessor for a dataset field on the current record/edit buffer.
-
FdcFieldContext<
T> - Runtime field context passed to FdcCustomColumn.cellBuilder.
- FdcFieldDef
- Base metadata definition for a dataset field.
-
FdcFieldFocusContext<
T> - Context supplied when a dataset-bound field gains or loses focus.
- FdcFieldStorage
- Storage/persistence metadata for a dataset field.
-
FdcFieldValueChangeAccepted<
T> - Accepts the proposed field value without replacing it.
-
FdcFieldValueChangeCanceled<
T> - Rejects a proposed field change, optionally with a user-facing message.
-
FdcFieldValueChangedContext<
T> - Read-only context emitted after a field value change has been accepted.
-
FdcFieldValueChangeReplacement<
T> - Accepts a field change but substitutes a different value.
-
FdcFieldValueChangeResult<
T> -
Decision returned from an
onValueChangingcallback. -
FdcFieldValueChangingContext<
T> - Mutable context supplied before a proposed field value is committed.
- FdcFilterBuilder
- Fluent AND-only builder for dataset filters.
- FdcFilterConditionBuilder
- Fluent condition step for one dataset field.
- FdcFilterOperatorTranslations
- Header filter operator text resources.
- FdcFilterOrderStep
- Ordering step returned while composing a fluent filter query.
- FdcFilterRangeValue
- Raw two-ended value used by the grid header range filter editor.
- FdcFocusOptions
- App/subtree-level focus behavior defaults for Flutter Data Components.
- FdcFocusScope
- Subtree-level FDC focus options provider.
- FdcFormatResolver
- Resolves FDC data-entry formats from a Flutter locale.
- FdcFormatSettings
-
Formatting settings applied to
flutter_data_componentswidgets. - FdcGrid
- High-performance data grid widget from the Community package.
- FdcGridButton
- Standard action button that can be placed in a grid toolbar or status bar.
- FdcGridCellIndicator
- Configures the visual indicator drawn around or beside the focused grid cell.
- FdcGridCellIndicatorStyle
- Configures active-cell indicator colors and geometry for grid interaction states.
- FdcGridCellPointerContext
- Immutable context supplied by grid cell pointer callbacks.
- FdcGridCellStyle
- Visual style applied to data cells in a column.
-
FdcGridColumn<
T> - Base metadata shared by every grid column type.
- FdcGridColumnGroup
- Visual definition for a column group rendered in the grid header.
- FdcGridColumnGroupStyle
- Visual styling for a single FdcGridColumnGroup header cell.
- FdcGridColumnPinning
- Configures interactive column pinning and labels for pinned header bands.
- FdcGridController
-
Public runtime command surface for an
FdcGrid. - FdcGridControlsStyle
- Shared visual metrics and colors for grid-owned buttons and compact controls.
- FdcGridCustomItem
- Fully custom widget item for a grid toolbar or status bar.
- FdcGridExportButton
- Built-in toolbar item that exports dataset rows through the FDC export pipeline.
- FdcGridFilterOptions
- Configures default operator and debounce behavior for grid-managed filters.
- FdcGridHeader
- Configuration for the grid header region and its column-header behavior.
- FdcGridHeaderFilters
- Configures visibility and styling of the grid-managed header filter row.
- FdcGridHeaderFilterStyle
- Visual configuration for the optional filter row below grid headers.
- FdcGridHeaderStyle
- Visual configuration for column headers, separators, and header interaction states.
- FdcGridItem
- Base class for items rendered inside a grid toolbar or status bar.
- FdcGridMainMenuButton
- Built-in toolbar item that exposes the grid main menu.
- FdcGridMenuContext
- Read-only context supplied to grid and column body-cell context menus.
- FdcGridOptions
-
Behavioral and layout options for an
FdcGrid. - FdcGridPageSizeSelector
- Selects the dataset page size while preserving the first visible global record offset where possible.
- Page navigation control for adapter-backed dataset paging.
- FdcGridPagingRecordInfo
- Displays the global record range of the currently loaded page.
- FdcGridPopupMenuStyle
- Colors and state styling for grid popup and column menus.
- FdcGridProgressBar
- Dataset work progress indicator for the grid status bar.
- FdcGridProgressStyle
- Placement and text presentation options for dataset progress shown by a grid.
- FdcGridResolvedCellIndicatorStyle
- Fully resolved paint values for the active-cell indicator border.
- FdcGridRowContext
- Lightweight, read-only row callback context used by FdcGrid callbacks.
- FdcGridRowIndicator
- Configures the leading grid region used for row status, numbering, selection, and the main menu.
- FdcGridRowIndicatorOptions
- Selects which status, numbering, and row-selection affordances appear in the row indicator.
- FdcGridSearchBar
- Built-in toolbar item for dataset-wide grid search.
- FdcGridSeparator
- Vertical separator for a grid toolbar or status bar.
- FdcGridSpacer
- Fixed horizontal spacing for a grid toolbar or status bar.
- FdcGridStatusBar
- Configures the optional grid status bar and its ordered item collection.
- FdcGridStatusBarStyle
- Layout and surface styling for the grid status bar and its item zones.
- FdcGridStatusText
- Built-in dataset status text containing record, state, filter, and sort info.
- FdcGridStyle
-
Visual style configuration for an
FdcGrid. - FdcGridSummary
- Configuration for the grid summary region and aggregate presentation.
- FdcGridSummaryCellStyle
- Per-column visual style override for grid summary row values.
- FdcGridSummaryStyle
- Visual configuration for the aggregate summary row below the viewport.
- FdcGridTheme
- Optional Flutter ThemeExtension bridge for FdcGrid.
- FdcGridThemeData
- Complete visual theme preset for FdcGrid.
- FdcGridThemes
- Built-in FdcGrid theme presets.
- FdcGridToolbar
-
Configuration for the optional toolbar displayed with an
FdcGrid. - FdcGridToolbarStyle
- Layout and search-control styling for the grid toolbar surface.
- FdcGridTranslations
- Grid text resources.
- FdcGuid
- Immutable GUID/UUID value used by GUID field runtime values.
- FdcGuidField
- GUID/UUID scalar field.
-
FdcIntegerColumn<
T> - Grid column for integer fields with numeric editing and display affixes.
- FdcIntegerEdit
- Data-aware editor for integer dataset fields.
- FdcIntegerField
- Integer dataset field definition with optional inclusive range validation.
- FdcKeyboardShortcut
- Framework-neutral keyboard shortcut used by FDC public APIs.
- FdcLocalizations
- Flutter Localizations integration for FDC components.
- FdcLocalizationsDelegate
- Default LocalizationsDelegate for FdcLocalizations.
- FdcLookupContext
- Shared context passed to grid and standalone editor lookup callbacks.
- FdcLookupResult
- Result returned by grid and standalone editor lookup callbacks.
-
FdcMemoColumn<
T> - Grid column specialized for long or multiline text fields.
- FdcMemoEdit
- Data-aware multiline editor for long text dataset fields.
- FdcMemoryDataAdapter
- In-memory adapter for local rows, tests, demos, and small client-side data.
- FdcMenuAction
- A selectable menu entry that invokes an action callback.
- FdcMenuCheckAction
- A checkable menu action with optional custom child content.
- FdcMenuEntry
- Shared internal menu entry model used by FDC controls.
- FdcMenuSeparator
- A non-interactive separator between logical groups of menu entries.
- FdcMenuTitle
- A non-interactive caption used to label a group of menu entries.
- FdcMenuWidgetEntry
- A menu entry that renders arbitrary child content without action semantics.
- FdcMessageDialog
- Modal informational dialog with a single dismiss action.
- FdcObjectField
- Field for custom object values that should be stored as-is in the dataset.
-
FdcOption<
T> - Static value used by combo-like controls and filters.
- FdcProgressBar
- Dataset-aware progress bar for FDC shell/status surfaces.
- FdcProgressBarStyle
-
Visual style for
FdcProgressBar. -
FdcProgressColumn<
T> - Grid column that renders numeric values as compact progress indicators.
- FdcProgressValue
- Value object for progress editors when styling varies per row.
- FdcRowAction
- A standardized row-level action rendered by FdcActionColumn.
- FdcRowActionContext
- Context passed to row actions rendered by FdcActionColumn.
- FdcRowContext
- Public read-only row context used by calculated fields and validators.
- FdcSortBuilder
- Fluent builder for dataset sorting.
- FdcSortOrderStep
- Direction step returned while composing a fluent dataset sort.
- FdcStringField
- Dataset field metadata for text values.
- FdcSubMenu
- A menu entry that opens a nested collection of child entries.
-
FdcTextColumn<
T> - Grid column for text dataset fields.
- FdcTextEdit
- Data-aware single-line editor for text dataset fields.
- FdcTextExportPayload
- UTF-8 text payload returned by text-based export writers.
- FdcTheme
- Subtree-level FDC visual theme provider.
- FdcThemeData
- Application/subtree-level visual theme for Flutter Data Components.
- FdcTime
- Time-of-day value used by FdcDataSet time fields.
-
FdcTimeColumn<
T> - Grid column specialized for time-of-day dataset fields.
- FdcTimeEdit
- Data-aware editor for time-of-day dataset fields.
- FdcTimeField
- Dataset field metadata for time-of-day values.
- FdcTranslationResolver
- Resolves FDC translations for a Flutter Locale.
- FdcTranslations
- User-facing FDC text resources.
- FdcValidationCodes
- Stable validation error codes emitted by built-in dataset validators.
- FdcValidationError
- Structured validation failure for a field or whole record.
- FdcValidationTranslations
- Validation text resources.
- IFdcDataAdapter
- Contract implemented by dataset data adapters.
- IFdcSynchronousDataAdapter
- Adapter contract for sources that can execute an immediate synchronous load.
Enums
- FdcAggregate
- Built-in aggregate operations shared by data-aware FDC components.
- FdcBooleanControl
- Visual controls supported by boolean FDC editors.
- FdcComboSearchMode
- Defines how combo popup search matches option labels.
- FdcConfirmationDefaultButton
- Selects which confirmation action receives initial keyboard focus.
- FdcDataAdapterFilterOperator
- Operators that an adapter may receive in FdcDataAdapterFilter.
- FdcDataApplyOperation
- Persistent operation represented by a change-set entry.
- Navigation intent for adapter paging.
- FdcDataPagingMode
- Dataset paging options and state helpers.
- FdcDataSetOperationExecutionMode
- How long-running dataset work should execute.
- FdcDataSetState
- Current lifecycle/editing state of an FdcDataSet.
- FdcDataSetWorkMode
- Whether the current dataset work can report a real percentage.
- FdcDataSetWorkPhase
- Coarse kind for dataset work reporting.
- FdcDataType
- Supported logical data types used by data-aware components.
- FdcDebouncePolicy
- Defines the available debounce policy values.
- FdcEditorType
- Supported visual editor modes.
- FdcErrorIndicatorMode
- Selects how a component presents validation/data-entry errors.
- FdcExportScope
- Row scope used by dataset/grid export operations.
- FdcExportTextAlignment
- Horizontal alignment hint used by presentation-oriented export writers.
- FdcExportValueMode
- Controls whether exported values remain typed/raw or are converted to text.
- FdcFieldEventHost
- Identifies the UI surface that emitted a field event.
- FdcFieldFocusChangeReason
- Describes why focus entered or left a dataset-bound field host.
- FdcFilterEditor
- Built-in header filter editor modes.
- FdcFilterOperator
- Supported filter operators used by data-aware components.
- FdcFocusTraversalPolicy
- Built-in focus traversal policy presets for FDC app/subtree scopes.
- FdcGridCellIndicatorMode
- Selects when the active-cell indicator is shown for editable and read-only cells.
- FdcGridColumnAutoSizeMode
- How a grid column participates in automatic width changes.
- FdcGridColumnPin
- Horizontal pinning mode for a grid column.
- FdcGridExportColumnMode
- Source used by the built-in grid toolbar export command.
- FdcGridHorizontalAlignment
- Horizontal alignment applied to a grid column.
- FdcGridHorizontalScrollMode
- Defines the available grid horizontal scroll mode values.
- FdcGridItemPlacement
- Placement zone used by shared grid items inside toolbars and status bars.
- FdcGridLines
- Controls which horizontal and vertical cell grid lines are rendered.
- FdcGridScrollbars
- Defines the available grid scrollbars values.
- FdcGridSearchBarMode
- Toolbar UI mode for the built-in grid search item.
- FdcGridVerticalLines
- Controls which vertical separators are drawn between grid regions and cells.
- FdcGridVerticalScrollMode
- Defines the available grid vertical scroll mode values.
- FdcKeyboardKey
- Keyboard keys supported by FdcKeyboardShortcut.
- FdcLookupMode
- Lookup invocation mode.
- FdcPageRefreshMode
-
Controls which page is opened by
FdcDataSet.paging.refreshPage. - FdcProgressBarDisplayMode
-
Controls how
FdcProgressBarvisualizes active dataset work. - FdcSearchMode
- Global dataset search matching mode.
- FdcSortType
- Sort direction for dataset and adapter ordering.
- FdcSummaryLabelAlignment
- Layout of an optional summary label inside its summary cell.
- FdcUpdateMode
- How dataset changes are persisted through an adapter.
Extensions
- FdcDecimalNumExtension on num
- Convenience conversion from Dart numeric literals to FdcDecimal.
- FdcDecimalStringExtension on String
- Convenience conversion from decimal text to FdcDecimal.
- FdcGridColumnPinProperties on FdcGridColumnPin
- Adds grid column pin properties convenience APIs.
Functions
-
showFdcConfirmationDialog(
BuildContext context, {required String title, required String message, String? yesText, String? noText, FdcConfirmationDefaultButton defaultButton = FdcConfirmationDefaultButton.no}) → Future< bool> - Shows a confirmation dialog and returns whether the user confirmed.
-
showFdcMessageDialog(
BuildContext context, {required String title, required String message, String? okText}) → Future< void> - Shows an informational message dialog.
Typedefs
-
FdcBadgeColorBuilder<
T> = Color Function(T? value) - Selects the badge color for the current cell value.
-
FdcBadgeTextBuilder<
T> = String Function(T? value) - Builds the text displayed by a badge column for the current cell value.
- FdcCalculatedFieldContext = FdcRowContext
- Backwards-compatible type alias for calculated field callbacks.
- FdcCalculatedFieldValue = Object? Function(FdcRowContext context)
- Computes the value of a calculated field for the supplied row.
- FdcCellValueFormatter = String Function(FdcGridColumn column, Object? value, {FdcColumnIdentity? runtimeColumnId})
- Formats an arbitrary grid cell value for display text.
-
FdcColumnValueChanged<
T> = void Function(FdcColumnValueChangedContext< T> context) - Column-level post-write notification.
-
FdcColumnValueChangeResult<
T> = FdcFieldValueChangeResult< T> - Result returned by a column value-changing callback.
-
FdcColumnValueChanging<
T> = FdcColumnValueChangeResult< T> ? Function(FdcColumnValueChangingContext<T> context) - Column-level pre-write interceptor.
-
FdcCustomCellBuilder<
T> = Widget Function(FdcFieldContext< T> field, FdcCellContext cell) - Builds a custom grid cell for a field-bound FdcCustomColumn.
- FdcDataSetAfterCancel = void Function(FdcDataSet dataSet)
- Called after original values have been restored, or an unposted insert has been discarded, and the dataset has returned to browse state.
- FdcDataSetAfterClose = void Function(FdcDataSet dataSet)
- Called after records, query state, selection, paging state, and edit buffers have been cleared and the dataset has entered the closed state.
- FdcDataSetAfterDelete = void Function(FdcDataSet dataSet)
- Called after an existing record has been removed or marked deleted and the dataset has returned to browse state, before listeners are notified.
- FdcDataSetAfterEdit = void Function(FdcDataSet dataSet)
- Called after the edit buffer has been created and the dataset entered edit state, before listeners are notified.
- FdcDataSetAfterInsert = void Function(FdcDataSet dataSet)
- Called after the new record has been inserted, activated, initialized with defaults, and placed in the current view, before listeners are notified.
- FdcDataSetAfterOpen = void Function(FdcDataSet dataSet)
- Called after an open operation has committed rows and entered browse state.
- FdcDataSetAfterPost = void Function(FdcDataSet dataSet)
- Called after posted values have been applied to the record and the dataset has returned to browse state, before listeners are notified.
- FdcDataSetAfterScroll = void Function(FdcDataSet dataSet, int previousRecordNumber, int currentRecordNumber)
- Called after the dataset current record changes through navigation.
- FdcDataSetBeforeCancel = void Function(FdcDataSet dataSet)
- Called before an active edit or insert buffer is discarded.
- FdcDataSetBeforeClose = void Function(FdcDataSet dataSet)
- Called immediately before a dataset is closed and its current view is cleared.
- FdcDataSetBeforeDelete = void Function(FdcDataSet dataSet)
- Called before an existing record is removed or marked deleted.
- FdcDataSetBeforeEdit = void Function(FdcDataSet dataSet)
- Called before the current record enters edit state and before an edit buffer is created.
- FdcDataSetBeforeInsert = void Function(FdcDataSet dataSet)
- Called before an inserted record is added to the record store or activated.
- FdcDataSetBeforeOpen = void Function(FdcDataSet dataSet)
- Called immediately before an open or reload operation begins.
- FdcDataSetBeforePost = void Function(FdcDataSet dataSet)
- Called before calculated values and validation are run for the active edit.
- FdcDataSetBeforeScroll = void Function(FdcDataSet dataSet, int previousRecordNumber, int currentRecordNumber)
- Called before the dataset current record changes through navigation.
-
FdcDataSetErrorEvent
= void Function(FdcDataSet dataSet, List<
FdcDataSetError> errors, Object? cause) - Called whenever the dataset records one or more user-visible errors.
- FdcDataSetFieldChanged = void Function(FdcDataSet dataSet, FdcFieldDef field, Object? oldValue, Object? newValue)
- Called after a field value changes in the active edit buffer or through a direct field-level update operation.
- FdcDataSetNewRecord = void Function(FdcDataSet dataSet)
- Called after a newly inserted record has been created, added to the dataset and placed in an active insert edit buffer.
- FdcDataSetStateChanged = void Function(FdcDataSet dataSet, FdcDataSetState previousState, FdcDataSetState currentState)
- Called synchronously whenever the dataset state value changes.
-
FdcDataSetValidationError
= void Function(FdcDataSet dataSet, List<
FdcValidationError> errors) - Called after post validation has produced one or more validation errors.
- FdcDataSetValueResolver = Object? Function(Object? value)
- Resolves a stored field value before local filter comparison.
- FdcDataSetWorkCompleted = void Function(FdcDataSet dataSet, FdcDataSetWorkInfo work)
- Called when a dataset work operation completes successfully.
- FdcDataSetWorkError = void Function(FdcDataSet dataSet, FdcDataSetWorkInfo work, Object error, StackTrace stackTrace)
- Called when a dataset work operation fails.
- FdcDataSetWorkStarted = void Function(FdcDataSet dataSet, FdcDataSetWorkInfo work)
- Called when a dataset work operation starts.
- FdcDecimalPrecisionValidationMessageBuilder = String Function(int? precision, int? scale)
- Builds a decimal precision and scale validation message.
-
FdcEditorLookup<
T> = Future< FdcLookupResult?> Function(FdcLookupContext context) - Asynchronous lookup callback for a standalone data-aware editor.
- FdcExportValueFormatter = String Function(Object? value)
- Formats a source value as presentation text for presentation-oriented writers.
- FdcFieldDefaultValueFactory = Object? Function()
- Factory used by field default values that must be evaluated for each newly inserted/appended record.
-
FdcFieldFocusCallback<
T> = void Function(FdcFieldFocusContext< T> context) - Callback invoked when focus enters or leaves a bound dataset field.
- FdcFieldLimitValidationMessageBuilder = String Function(String fieldLabel, Object limit)
- Builds a validation message for a field and limit value.
- FdcFieldValidationMessageBuilder = String Function(String fieldLabel)
- Builds a validation message for a field label.
- FdcFieldValidator = String? Function(FdcRowContext row, Object? value)
- Validates one field value in the context of its row.
-
FdcFieldValueChangedCallback<
T> = void Function(FdcFieldValueChangedContext< T> context) - Callback invoked after an accepted field value change has been applied.
-
FdcFieldValueChangingCallback<
T> = FdcFieldValueChangeResult< T> ? Function(FdcFieldValueChangingContext<T> context) - Callback invoked before a proposed field value is committed.
- FdcFieldValueFormatter = String Function(String fieldName, Object? value)
- Formats a field value by dataset field name.
-
FdcFilterOptionBuilder
= Widget Function(BuildContext context, FdcOption<
Object?> option) - Builds the widget shown for one option in a column filter selector.
- FdcGridCanEditColumn = bool Function(int rowIndex, FdcGridColumn column, FdcGridRowContext row)
- Decides whether a specific column may be edited for a row.
- FdcGridCanEditRow = bool Function(int rowIndex, FdcGridRowContext row)
-
Decides whether the row at
rowIndexmay enter edit traversal. -
FdcGridCellChanged
= FdcFieldValueChangedCallback<
Object?> - Receives notification after an accepted grid cell value has been committed.
-
FdcGridCellChangedContext
= FdcFieldValueChangedContext<
Object?> - Grid specialization of the context delivered after an accepted cell change.
-
FdcGridCellFocusEvent
= FdcFieldFocusCallback<
Object?> - Receives cell focus enter/exit notifications after the grid resolves a focus transition.
-
FdcGridCellFocusEventContext
= FdcFieldFocusContext<
Object?> - Grid specialization of focus context used by cell enter/exit callbacks.
- FdcGridCellPointerEvent = void Function(FdcGridCellPointerContext context)
- Receives a completed grid cell pointer gesture notification.
-
FdcGridColumnFocusEvent
= FdcFieldFocusCallback<
Object?> - Receives column focus enter/exit notifications emitted by grid navigation.
-
FdcGridColumnFocusEventContext
= FdcFieldFocusContext<
Object?> - Grid specialization of focus context used by column enter/exit callbacks.
- FdcGridExportCompleted = void Function(FdcExportResult result)
- Called after the built-in grid export command has generated an FdcExportResult.
- FdcGridFocusChangeReason = FdcFieldFocusChangeReason
- Reason associated with a grid focus transition.
-
FdcGridLookup<
T> = Future< FdcLookupResult?> Function(FdcLookupContext context) - Asynchronous lookup callback for a grid column.
-
FdcGridMenuBuilder
= List<
FdcMenuEntry> Function(FdcGridMenuContext context) - Builds body-cell context-menu entries.
-
FdcGridRowFocusEvent
= FdcFieldFocusCallback<
Object?> - Receives row focus enter/exit notifications emitted by grid navigation.
-
FdcGridRowFocusEventContext
= FdcFieldFocusContext<
Object?> - Grid specialization of focus context used by row enter/exit callbacks.
- FdcProgressTextBuilder = String Function(num? value)
- Formats the label shown for a progress-column value.
-
FdcRecordValidator
= List<
FdcValidationError> Function(FdcRowContext row) - Validates a row as a whole after field-level values are available.
- FdcRowActionCallback = void Function(FdcRowActionContext context)
- Callback used by FdcRowAction to execute row-level commands.
- FdcRowActionPredicate = bool Function(FdcRowActionContext context)
- Predicate used by FdcRowAction to resolve row-level state.
- FdcSearchFieldTextFormatter = String Function(Object? value)
- Converts a field value into searchable text for prepared dataset search.
Exceptions / Errors
- FdcDataAdapterException
- Canonical exception raised at the adapter/dataset boundary.
- FdcDataSetAbortException
- Signals an intentional cancellation of the current dataset operation.
- FdcDataSetException
- Base exception for dataset and adapter operation failures.
- FdcDataSetValidationException
- Exception containing one or more dataset validation errors.