StateMVC<T extends StatefulWidget> class abstract

The State Object seen as the 'View of the State.' Uses the mixins: WidgetsBindingObserver, _ControllerList, _StateListeners

Inheritance
Implemented types
Mixed in types
Implementers

Constructors

StateMVC([ControllerMVC? _controller])
With an optional Controller parameter, this constructor imposes its own Error Handler.

Properties

context BuildContext
The location in the tree where this widget builds.
no setterinherited
controller ControllerMVC?
Provide the 'main' controller to this 'State View.' If _controller == null, get the 'first assigned' controller if any.
no setter
currentErrorFunc FlutterExceptionHandler?
Save the current Error Handler.
final
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
Readily determine if the State object is possibly to be disposed of.
no setter
hashCode int
The hash code for this object.
no setterinherited
inDebugger 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
keyId String
The unique key identifier for this State object.
no setteroverride
lastContext BuildContext?
Returns the 'latest' context in the App.
no setterinherited
map Map<String, ControllerMVC>
Returns a Map containing all the 'Controllers' associated with this StateMVC object each with their unique 'key' identifier.
no setterinherited
mounted bool
Whether this State object is currently in a tree.
no setterinherited
rootCon ControllerMVC?
Returns 'the first' Controller associated with this StateMVC object. Returns null if empty.
no setterinherited
rootState AppStateMVC<AppStatefulWidgetMVC>?
Returns the 'first' StateMVC object in the App
no setterinherited
runtimeType Type
A representation of the runtime type of the object.
no setterinherited
widget → T
You need to be able access the widget.
no setteroverride

Methods

activate() → void
Called when this object is reinserted into the tree after having been removed via deactivate.
override
add(ControllerMVC? controller) String
Add a specific Controller to this View. Returns the Controller's unique String identifier.
override
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
addConId(ControllerMVC con) String
Adds a 'Controller' to be associated with this StateMVC object and returns Controller's the unique 'key' identifier assigned to it.
inherited
addList(List<ControllerMVC>? list) List<String>
Add a list of 'Controllers' to be associated with this StatMVC object.
override
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
Implement the build() function.
override
buildInherited() → void
Rebuild the InheritedWidget of the 'closes' InheritedStateMVC object if any.
buildWidget(BuildContext context) Widget
Implement this function instead of the build() function to utilize a built-in FutureBuilder Widget and InheritedWidget.
override
contains(ControllerMVC con) bool
Returns true if the specified 'Controller' is associated with this StateMVC object.
inherited
controllerById(String? keyId) ControllerMVC?
Retrieve a Controller by its a unique String identifier.
controllerByType<U extends ControllerMVC>() → U?
Retrieve a Controller in the MVC framework by type.
deactivate() → void
The framework calls this method whenever it removes this State object from the tree.
override
debugFillProperties(DiagnosticPropertiesBuilder properties) → void
Add additional properties associated with the node.
inherited
dependOnInheritedWidget(BuildContext? context) bool
Link a widget to the InheritedWidget
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.
override
didChangeAccessibilityFeatures() → void
Called when the system changes the set of currently active accessibility features.
override
didChangeAppLifecycleState(AppLifecycleState state) → void
Called when the system puts the app in the background or returns the app to the foreground.
override
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() funciton is called it's dependencies' build() function are also called but not before their didChangeDependencies() function. Subclasses rarely use this method.
override
didChangeLocale(Locale locale) → 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.
override
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.
override
didChangePlatformBrightness() → void
Called when the platform brightness changes.
override
didChangeTextScaleFactor() → void
Called when the platform's text scale factor changes.
override
didHaveMemoryPressure() → void
Called when the system is running low on memory.
override
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.
override
didPushRoute(String route) Future<bool>
Called when the host tells the app to push a new route onto the navigator.
override
didPushRouteInformation(RouteInformation routeInformation) Future<bool>
Called when the host tells the application to push a new RouteInformation and a restoration state onto the router.
override
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.
override
dispose() → void
The framework calls this method when this StateMVC object will never build again and will be disposed of.
override
inactiveLifecycleState() → void
Apps in this state should assume that they may be pausedLifecycleState at any time.
override
initAsync() Future<bool>
Asynchronous operations must complete successfully.
override
initState() → void
The framework will call this method exactly once. Only when the StateMVC object is first created.
override
listControllers(List<String> keys) List<ControllerMVC?>
Returns the list of 'Controllers' associated with this StateMVC object.
inherited
noSuchMethod(Invocation invocation) → dynamic
Invoked when a nonexistent method or property is accessed.
inherited
onAsyncError(FlutterErrorDetails details) bool
Supply an 'error handler' routine if something goes wrong in the corresponding initAsync() routine.
inherited
onError(FlutterErrorDetails details) → void
Supply an 'error handler' routine to fire when an error occurs. Allows the user to define their own with each StateMVC object.
pausedLifecycleState() → void
The application is not currently visible to the user, not responding to user input, and running in the background.
override
reassemble() → void
During development, if a hot reload occurs, the reassemble method is called. This provides an opportunity to reinitialize any data that was prepared in the initState method.
override
refresh() → void
Allows the user to call setState() within the Controller.
remove(String keyId) bool
Remove a specific associated 'Controller' from this StateMVC 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.
override
setState(VoidCallback fn) → void
Allows 'external' routines can call this function.
override
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

Operators

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