AppError class

The Error Screen if something happens at start up.

Inheritance

Constructors

AppError(Object exception, {Key? key})
Supply an Exception object from the startup error.

Properties

actions Map<Type, Action<Intent>>?
getter/setter pairinherited
app App?
Reference to the 'app' object.
getter/setter pairinherited
backButtonDispatcher BackButtonDispatcher?
getter/setter pairinherited
builder TransitionBuilder?
getter/setter pairinherited
checkerboardOffscreenLayers bool?
getter/setter pairinherited
checkerboardRasterCacheImages bool?
getter/setter pairinherited
color Color?
getter/setter pairinherited
context BuildContext
The location in the tree where this widget builds.
no setterinherited
controller StateXController?
Provide the 'main' controller to this 'State View.' If _controller == null, get the 'first assigned' controller if any.
no setterinherited
cupertinoApp CupertinoApp?
getter/setter pairinherited
cupertinoKey GlobalKey<State<StatefulWidget>>
Key for the CupertinoApp
getter/setter pairinherited
darkTheme ThemeData?
getter/setter pairinherited
dataObject Object?
This is of type Object allowing you to propagate any class object you wish down the widget tree.
getter/setter pairinherited
deactivated bool
State object's deactivated() was called.
getter/setter pairinherited
debugPaintBaselinesEnabled bool?
getter/setter pairinherited
debugPaintLayerBordersEnabled bool?
getter/setter pairinherited
debugPaintPointersEnabled bool?
getter/setter pairinherited
debugPaintSizeEnabled bool?
Highlights UI while debugging.
getter/setter pairinherited
debugRepaintRainbowEnabled bool?
getter/setter pairinherited
debugRepaintTextRainbowEnabled bool?
getter/setter pairinherited
debugShowCheckedModeBanner bool?
getter/setter pairinherited
debugShowMaterialGrid bool?
getter/setter pairinherited
debugShowWidgetInspector bool?
getter/setter pairinherited
detached bool
State object was in 'paused' state
getter/setter pairinherited
disposed bool
Flag indicating this State object is disposed. Will be garbage collected. property, mounted, is then set to false.
getter/setter pairinherited
endState State<StatefulWidget>?
Return the 'latest' State object
no setterinherited
errorMsg String
Simply display the exception.
no setterinherited
hadSystemEvent bool
State object experienced a system event
no setterinherited
hasError bool
Indicate if an exception had occurred.
no setterinherited
hashCode int
The hash code for this object.
no setterinherited
home Widget?
The App's 'home screen'
finalinherited
identifier String
The unique identifier for this State object.
no setterinherited
inActions Map<Type, Action<Intent>>? Function()?
Returns Map of 'Intent Actions' if any.
finalinherited
inactive bool
State object was in 'inactive' state
getter/setter pairinherited
inAsyncError bool? Function(FlutterErrorDetails details)?
Returns the App's 'Async Error Handler' if any.
finalinherited
inBackButtonDispatcher BackButtonDispatcher Function()?
Returns the 'Back Button' routine if any.
finalinherited
inCheckerboardOffscreenLayers bool? Function()?
Returns 'Off Screen Layers Checkerboard' boolean indicator if any.
finalinherited
inCheckerboardRasterCacheImages bool? Function()?
Returns 'Raster Cache Checkerboard' boolean indicator if any.
finalinherited
inColor Color? Function()?
Returns the App's Color if any.
finalinherited
inDarkTheme ThemeData? Function()?
Returns the App's 'Dark Theme' ThemeData if any.
finalinherited
inDebugger bool
Deprecated soon. Use inDebugMode.
no setterinherited
inDebugMode bool
Determines if running in an IDE or in production. Returns true if the App is under in the Debugger and not production.
no setterinherited
inDebugShowCheckedModeBanner bool? Function()?
Returns 'Show Debug Banner' boolean indicator if any.
finalinherited
inDebugShowMaterialGrid bool? Function()?
Returns 'Show Material Grid' boolean indicator if any.
finalinherited
inError → void Function(FlutterErrorDetails details)?
Returns the App's 'Error Handler' if any.
finalinherited
inGenerateTitle GenerateAppTitle?
Returns the 'Generate Title' routine if any.
finalinherited
inheritedBuilder → _AppInheritedWidget Function(Widget child)
Supply a child Widget to the returning InheritedWidget's child parameter.
finalinherited
inheritedType Type
Return the 'type' of InheritedWidget
no setterinherited
inHome Widget Function()?
Returns the home screen if any.
finalinherited
inInheritedMediaQuery bool? Function()?
Returns the App's 'Inherited Media Query' routine if any.
finalinherited
inInitAsync Future<bool> Function()?
Perform asynchronous operations
finalinherited
inInitialRoute String Function()?
Returns the initial Route if any.
finalinherited
inInitState → void Function()?
Perform synchronous initialization
finalinherited
iniOSTheme CupertinoThemeData? Function()?
Returns the App's CupertinoThemeData if any.
finalinherited
initialRoute String?
getter/setter pairinherited
inLocale Locale? Function()?
Returns current Locale if any.
finalinherited
inLocaleListResolutionCallback LocaleListResolutionCallback?
Returns 'Locale Resolutions' routine if any.
finalinherited
inLocaleResolutionCallback LocaleResolutionCallback?
Returns 'Local Resolution' routine if any.
finalinherited
inLocalizationsDelegates Iterable<LocalizationsDelegate> Function()?
Returns the 'Localization Delegates' if any.
finalinherited
inNavigatorObservers List<NavigatorObserver> Function()?
Returns a List of Navigation Observers if any.
finalinherited
inOnGenerateRoute RouteFactory Function()?
Returns the 'Generate Routes' routine if any.
finalinherited
inOnUnknownRoute RouteFactory Function()?
Returns the 'Unknown Route' if any.
finalinherited
inRestorationScopeId String? Function()?
Returns the 'Restore Scope Id' routine if any.
finalinherited
inRouteInformationParser RouteInformationParser<Object> Function()?
Returns the Route Parser if any.
finalinherited
inRouteInformationProvider RouteInformationProvider Function()?
Returns the Route Provider if any.
finalinherited
inRouterConfig RouterConfig<Object>? Function()?
Returns the Route Config if any.
finalinherited
inRouterDelegate RouterDelegate<Object> Function()?
Returns the Route Delegate if any.
finalinherited
inRoutes Map<String, WidgetBuilder> Function()?
Returns a Map of Routes if any.
finalinherited
inScrollBehavior ScrollBehavior? Function()?
Returns the App's ScrollBehavior if any.
finalinherited
inShortcuts Map<LogicalKeySet, Intent>? Function()?
Returns Map of 'LogicalKeySets' if any.
finalinherited
inShowPerformanceOverlay bool? Function()?
Returns 'Show Performance Overlay' boolean indicator if any.
finalinherited
inShowSemanticsDebugger bool? Function()?
Returns 'Show Semantics' boolean indicator if any.
finalinherited
inSupportedLocales List<Locale>? Function()?
Returns the Locale Iteration if any.
finalinherited
inTheme ThemeData? Function()?
Returns the App's ThemeData if any.
finalinherited
inThemeMode ThemeMode? Function()?
Returns the App's ThemeMode if any.
finalinherited
inTitle String Function()?
Returns the App's title if any.
finalinherited
inTransBuilder TransitionBuilder Function()?
Returns the 'Transition Builder' if any.
finalinherited
iOSTheme CupertinoThemeData?
getter/setter pairinherited
isCupertino bool?
Is using the Cupertino Design UI.
no setterinherited
isEndState bool
This is the 'latest' State being viewed by the App.
no setterinherited
isMaterial bool?
Is using the Material Design UI.
no setterinherited
key Key?
The 'App State Objects' Key
finalinherited
lastContext BuildContext?
Returns the 'latest' context in the App.
no setterinherited
lastState State<StatefulWidget>?
no setterinherited
lastStateX StateX<StatefulWidget>?
no setterinherited
locale Locale?
getter/setter pairinherited
localeListResolutionCallback LocaleListResolutionCallback?
getter/setter pairinherited
localeResolutionCallback LocaleResolutionCallback?
getter/setter pairinherited
localizationsDelegates Iterable<LocalizationsDelegate>?
getter/setter pairinherited
materialApp MaterialApp?
The MaterialApp and CupertinoApp if provided.
getter/setter pairinherited
materialKey GlobalKey<State<StatefulWidget>>
Key for the MaterialApp;
getter/setter pairinherited
mounted bool
Whether this State object is currently in a tree.
no setterinherited
All the fields found in the widgets, MaterialApp and CupertinoApp
getter/setter pairinherited
getter/setter pairinherited
onGenerateRoute RouteFactory?
getter/setter pairinherited
onGenerateTitle GenerateAppTitle?
getter/setter pairinherited
onUnknownRoute RouteFactory?
getter/setter pairinherited
parentState State<StatefulWidget>?
Reference the 'parent' State object
getter/setter pairinherited
paused bool
State object was in 'paused' state
getter/setter pairinherited
restorationScopeId String?
getter/setter pairinherited
resumed bool
State object was in 'resumed' state
getter/setter pairinherited
rootCon StateXController?
Returns 'the first' StateXController associated with this StateX object. Returns null if empty.
no setterinherited
rootState AppStateX<StatefulWidget>?
Returns the 'first' StateX object in the App
no setterinherited
routeInformationParser RouteInformationParser<Object>?
getter/setter pairinherited
routeInformationProvider RouteInformationProvider?
getter/setter pairinherited
routerConfig RouterConfig<Object>?
getter/setter pairinherited
routerDelegate RouterDelegate<Object>?
getter/setter pairinherited
routes Map<String, WidgetBuilder>?
getter/setter pairinherited
runtimeType Type
A representation of the runtime type of the object.
no setterinherited
scaffoldMessengerKey GlobalKey<ScaffoldMessengerState>?
getter/setter pairinherited
scrollBehavior ScrollBehavior?
getter/setter pairinherited
shortcuts Map<LogicalKeySet, Intent>?
getter/setter pairinherited
showPerformanceOverlay bool?
getter/setter pairinherited
showSemanticsDebugger bool?
getter/setter pairinherited
stackTrace StackTrace?
The StackTrace
no setterinherited
startState State<StatefulWidget>?
Return the first State object
no setterinherited
supportedLocales List<Locale>?
getter/setter pairinherited
switchUI bool?
Use Cupertino UI in Android and vice versa.
getter/setter pairinherited
theme ThemeData?
getter/setter pairinherited
themeMode ThemeMode?
getter/setter pairinherited
title String?
getter/setter pairinherited
useCupertino bool?
Explicitly use the Cupertino theme
getter/setter pairinherited
useInheritedMediaQuery bool?
getter/setter pairinherited
useMaterial bool?
Explicitly use the Material theme
getter/setter pairinherited
widget StatefulWidget
You need to be able access the widget.
no setterinherited

Methods

activate() → void
Called when this object is reinserted into the tree after having been removed via deactivate.
inherited
add(StateXController? controller) String
Add a specific StateXController to this View. Returns the StateXController's unique String identifier.
inherited
addAfterListener(StateListener listener) bool
Add a listener fired 'after' the main controller runs.
inherited
addBeforeListener(StateListener listener) bool
Add a listener fired 'before' the main controller runs.
inherited
addList(List<StateXController>? list) List<String>
Add a list of 'Controllers' to be associated with this StatX object.
inherited
addListener(StateListener listener) bool
Add a listener fired 'after' the main controller runs.
inherited
afterContains(StateListener listener) bool
Returns true of the listener specified is already added.
inherited
afterList(List<String> keys) List<StateListener>
Returns the list of 'after' listeners by matching key identifiers.
inherited
afterListener(String key) StateListener?
Returns the specified 'after' listener.
inherited
beforeContains(StateListener listener) bool
Returns true of the listener specified is already added.
inherited
beforeList(List<String> keys) List<StateListener>
Returns a List of 'before' listeners by matching key identifiers.
inherited
beforeListener(String key) StateListener?
Returns the specified 'before' listener.
inherited
build(BuildContext context) Widget
Override build to avoid the built-in Future Builder. It's been run.
inherited
buildChild(BuildContext context) Widget
Override to impose your own WidgetsApp (like CupertinoApp or MaterialApp)
inherited
buildF(BuildContext context) Widget
Use this build instead if you don't want to use the built-in InheritedWidget
inherited
buildIn(BuildContext context) Widget
Implement this function to compose the App's View. Return the 'child' Widget is then passed to an InheritedWidget
inherited
buildInherited() → void
Rebuild the InheritedWidget and its dependencies.
inherited
buildWidget(BuildContext context) Widget
Deprecated soon
inherited
catchError(Exception? ex) → void
Catch and explicitly handle the error.
inherited
changeUI(String? ui) → void
Explicitly change to a particular interface.
inherited
contains(StateXController con) bool
Returns true if the specified 'StateXController' is associated with this StateX object.
inherited
controllerById(String? keyId) StateXController?
Retrieve a StateXController by its a unique String identifier.
inherited
controllerByType<U extends StateXController>() → U?
Retrieve a StateXController by type.
inherited
copy([StateX<StatefulWidget>? state]) → void
Copy particular properties from another StateX
inherited
deactivate() → void
The framework calls this method whenever it removes this State object from the tree.
inherited
debugFillProperties(DiagnosticPropertiesBuilder properties) → void
Add additional properties associated with the node.
inherited
dependOnInheritedWidget(BuildContext? context) bool
Link a widget to a InheritedWidget of type U
inherited
detachedLifecycleState() → void
Either be in the progress of attaching when the engine is first initializing or after the view being destroyed due to a Navigator pop.
inherited
didChangeAccessibilityFeatures() → void
Called when the system changes the set of currently active accessibility features.
inherited
didChangeAppLifecycleState(AppLifecycleState state) → void
Called when the system puts the app in the background or returns the app to the foreground.
inherited
didChangeDependencies() → void
This method is also called immediately after initState. Otherwise called only if this State object's Widget is a dependency of InheritedWidget. When a InheritedWidget's build() function is called the dependent widget's build() function is also called but not before their didChangeDependencies() function. Subclasses rarely use this method.
inherited
didChangeLocales(List<Locale>? locales) → void
Called when the system tells the app that the user's locale has changed. For example, if the user changes the system language settings.
inherited
didChangeMetrics() → void
Called when the application's dimensions change. For example, when a phone is rotated.
inherited
didChangePlatformBrightness() → void
Called when the platform brightness changes.
inherited
didChangeTextScaleFactor() → void
Called when the platform's text scale factor changes.
inherited
didChangeViewFocus(ViewFocusEvent event) → void
Called whenever the PlatformDispatcher receives a notification that the focus state on a view has changed.
inherited
didHaveMemoryPressure() → void
Called when the system is running low on memory.
inherited
didPop() → void
Called when this route has been popped off.
inherited
didPopNext() → void
The top route has been popped off, and this route shows up.
inherited
didPopRoute() Future<bool>
Called when the system tells the app to pop the current route. For example, on Android, this is called when the user presses the back button. Observers are notified in registration order until one returns true. If none return true, the application quits.
inherited
didPush() → void
Called when this route has been pushed.
inherited
didPushNext() → void
New route has been pushed, and this route is no longer visible.
inherited
didPushRoute(String route) Future<bool>
Called when the host tells the app to push a new route onto the navigator.
inherited
didPushRouteInformation(RouteInformation routeInformation) Future<bool>
Called when the host tells the application to push a new RouteInformation and a restoration state onto the router.
inherited
didRequestAppExit() Future<AppExitResponse>
Called when a request is received from the system to exit the application.
inherited
didUpdateWidget(covariant StatefulWidget oldWidget) → void
Override this method to respond when its StatefulWidget is re-created. The framework always calls build after calling didUpdateWidget, which means any calls to setState in didUpdateWidget are redundant.
inherited
dispose() → void
Clean up resources before the app is finally terminated.
inherited
forEach(void func(StateXController con), {bool? reversed}) bool
To externally 'process' through the controllers. Invokes func on each StateXController possessed by this StateX object. With an option to process in reversed chronological order
inherited
forEachState(void func(StateX<StatefulWidget> state), {bool? reversed}) bool
To externally 'process' through the State objects. Invokes func on each StateX possessed by this StateX object. With an option to process in reversed chronological order
inherited
handleCancelBackGesture() → void
Called when a predictive back gesture is canceled, indicating that no navigation should occur.
inherited
handleCommitBackGesture() → void
Called when a predictive back gesture is finished successfully, indicating that the current route should be popped.
inherited
handleStartBackGesture(PredictiveBackEvent backEvent) bool
Called at the start of a predictive back gesture.
inherited
handleUpdateBackGestureProgress(PredictiveBackEvent backEvent) → void
Called when a predictive back gesture moves.
inherited
inactiveLifecycleState() → void
Apps in this state should assume that they may be pausedLifecycleState at any time.
inherited
inheritedElement(BuildContext? context) InheritedElement?
inherited
inheritedNeedsBuild([Object? object]) → void
Call the build() functions of all the dependencies of the _InheritedWidget widget.
inherited
initAsync() Future<bool>
Used to complete asynchronous operations
inherited
initInheritedState<V extends InheritedWidget>(V inheritedWidgetBuilder(Widget child)) → InheritedStatefulWidget<InheritedWidget>
Initialize the InheritedWidget State object
inherited
initState() → void
Supply a GlobalKey to the CupertinoApp and the MaterialApp
inherited
listControllers(List<String> keys) List<StateXController?>
Returns the list of 'Controllers' associated with this StateX object.
inherited
listStates(List<String> keys) List<StateX<StatefulWidget>>
Returns a List of StateX objects using unique String identifiers.
inherited
noSuchMethod(Invocation invocation) → dynamic
Invoked when a nonexistent method or property is accessed.
inherited
notifyClients() → void
In harmony with Flutter's own API
inherited
onActions() Map<Type, Action<Intent>>?
Returns Map of 'Intent Actions' if any.
inherited
onAsyncError(FlutterErrorDetails details) → void
Supply an 'error handler' routine if something goes wrong in the corresponding initAsync() routine.
inherited
onBackButtonDispatcher() BackButtonDispatcher?
Returns the 'Back Button' routine if any.
inherited
onBuilder() TransitionBuilder?
Returns the 'Transition Builder' if any.
inherited
onCheckerboardOffscreenLayers() bool?
Returns 'Off Screen Layers Checkerboard' boolean indicator if any.
inherited
onCheckerboardRasterCacheImages() bool?
Returns 'Raster Cache Checkerboard' boolean indicator if any.
inherited
onColor() Color?
Returns the App's Color if any.
inherited
onDarkTheme() ThemeData?
Returns the App's 'Dark Theme' ThemeData if any.
inherited
onDebugShowCheckedModeBanner() bool?
Returns 'Show Debug Banner' boolean indicator if any.
inherited
onDebugShowMaterialGrid() bool?
Returns 'Show Material Grid' boolean indicator if any.
inherited
onError(FlutterErrorDetails details) → void
Override if you like to customize error handling.
inherited
onHome() Widget?
Returns the home screen if any.
inherited
onInheritedMediaQuery() bool?
Returns the App's 'Inherited Media Query' routine if any.
inherited
onInitialRoute() String?
Returns the initial Route if any.
inherited
oniOSTheme() CupertinoThemeData?
Returns the App's CupertinoThemeData if any.
inherited
onLocale() Locale?
Returns current Locale if any.
inherited
onLocaleListResolutionCallback(List<Locale>? locales, Iterable<Locale> supportedLocales) Locale?
Returns 'Locale Resolutions' routine if any.
inherited
onLocaleResolutionCallback(Locale? locale, Iterable<Locale> supportedLocales) Locale?
Returns 'Local Resolution' routine if any. Turn to the I10n class to provide the locale.
inherited
onLocalizationsDelegates() Iterable<LocalizationsDelegate>?
Returns the 'Localization Delegates' if any.
inherited
onNavigatorKey() GlobalKey<NavigatorState>
Returns the App's Navigator's Key.
inherited
onNavigatorObservers() List<NavigatorObserver>?
Returns a List of Navigation Observers if any.
inherited
onOnGenerateRoute() RouteFactory?
Returns the 'Generate Routes' routine if any.
inherited
onOnGenerateTitle(BuildContext context) GenerateAppTitle?
Returns the 'Generate Title' routine if any.
inherited
onOnUnknownRoute() RouteFactory?
Returns the 'Unknown Route' if any.
inherited
onRestorationScopeId() String?
Returns the 'Restore Scope Id' routine if any.
inherited
onRouteInformationParser() RouteInformationParser<Object>?
Returns the Route Parser if any.
inherited
onRouteInformationProvider() RouteInformationProvider?
Returns the Route Provider if any.
inherited
onRouterConfig() RouterConfig<Object>?
Returns the Route Config if any.
inherited
onRouterDelegate() RouterDelegate<Object>?
Returns the Route Delegate if any.
inherited
onRoutes() Map<String, WidgetBuilder>?
Returns a Map of Routes if any.
inherited
onScaffoldMessengerKey() GlobalKey<ScaffoldMessengerState>
Returns the App's ScaffoldMessenger Key.
inherited
onScrollBehavior() ScrollBehavior?
Returns the App's ScrollBehavior if any.
inherited
onShortcuts() Map<LogicalKeySet, Intent>?
Returns Map of 'LogicalKeySets' if any.
inherited
onShowPerformanceOverlay() bool?
Returns 'Show Performance Overlay' boolean indicator if any.
inherited
onShowSemanticsDebugger() bool?
Returns 'Show Semantics' boolean indicator if any.
inherited
onSupportedLocales() List<Locale>?
Returns the Locale Iteration if any.
inherited
onTheme() ThemeData?
Returns the App's ThemeData if any.
inherited
onThemeMode() ThemeMode?
Returns the App's ThemeMode if any.
inherited
onTitle() String
Returns the App's title if any.
inherited
pausedLifecycleState() → void
The application is not currently visible to the user, not responding to user input, and running in the background.
inherited
reassemble() → void
During development, if a hot reload occurs, the reassemble method is called.
inherited
rebuildLastState() → void
Return the latest StateX object currently being used if any.
inherited
recordException([Object? error, StackTrace? stack]) Exception?
Return the 'last' error if any.
inherited
refresh() → void
Rebuild the 'latest/current' State object and the 'root/first' State object This is to address the possibility an App has called another App.
inherited
refreshLastState() → void
Replaced by a more accurate sounding function.
inherited
reload() → void
Reload the whole App
inherited
remove(StateXController? controller) String
Remove a specific StateXController to this View. Returns the StateXController's unique String identifier.
inherited
removeByKey(String keyId) bool
Remove a specific associated 'StateXController' from this StateX object by using its unique 'key' identifier.
inherited
removeListener(StateListener listener) bool
Removes the specified listener.
inherited
resumedLifecycleState() → void
The application is visible and responding to user input.
inherited
setRootStateX(StateX<StatefulWidget> state) → void
Important to record the 'root' StateX object. Its InheritedWidget!
inherited
setState(VoidCallback fn) → void
Calls the State object's setState() function if not (see class SetState).
inherited
setSuperState(VoidCallback fn) → void
Provide a means to rebuild this State object anyway.
inherited
stateById(String? id) StateX<StatefulWidget>?
Returns a StateView object using a unique String identifier.
inherited
stateByType<T extends StateX<StatefulWidget>>() → T?
Retrieve the State object by type Returns null if not found
inherited
statesById(List<String> ids) Map<String, StateX<StatefulWidget>>
Returns a Map of StateView objects using unique String identifiers.
inherited
toDiagnosticsNode({String? name, DiagnosticsTreeStyle? style}) DiagnosticsNode
Returns a debug representation of the object that is used by debugging tools and by DiagnosticsNode.toStringDeep.
inherited
toString({DiagnosticLevel minLevel = DiagnosticLevel.info}) String
A string representation of this object.
inherited
toStringShort() String
A brief description of this object, usually just the runtimeType and the hashCode.
inherited
updateNewStateX(covariant StateX<StatefulWidget> oldState) → void
Update the 'new' StateX object from the 'old' StateX object. Returning to this app from another app will re-create the State object You 'update' the current State object using this function.
inherited

Operators

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