automaticSystemUiAdjustment property

bool automaticSystemUiAdjustment
getter/setter pair

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.

If there is no AnnotatedRegionLayer on the bottom, the hit-test result from the top provides the system nav bar settings. If there is no AnnotatedRegionLayer on the top, the hit-test result from the bottom provides the system status 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:

Implementation

bool automaticSystemUiAdjustment = true;