automaticSystemUiAdjustment property

Whether Flutter should automatically compute the desired system UI.

When this setting is enabled, Flutter will hit-test the layer tree at the top and bottom of the screen on each frame looking for an AnnotatedRegionLayer with an instance of a SystemUiOverlayStyle. The hit-test result from the top of the screen provides the status bar settings and the hit-test result from the bottom of the screen provides the system nav bar settings.

Setting this to false does not cause previous automatic adjustments to be reset, nor does setting it to true cause the app to update immediately.

If you want to imperatively set the system ui style instead, it is recommended that automaticSystemUiAdjustment is set to false.

See also:

• AnnotatedRegion, for placing SystemUiOverlayStyle in the layer tree.
• SystemChrome.setSystemUIOverlayStyle, for imperatively setting the system ui style.