Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit ea61ca93 authored by Andrew Solovay's avatar Andrew Solovay
Browse files

docs: Removed section on overlaying action bar 

When we replaced the action bar docs with the new app bar docs,
we chose not to document the deprecated "overlaying the action bar"
functionality. Removing a separate training section that relies on
the now-removed material.

bug: 26502436
Change-Id: I0fe3715a39d5591be6eecbacbd7f68134ecc9f96
parent 83a3c676

docs/html/training/system-ui/status.jd

+1 −32
Original line number Diff line number Diff line
@@ -13,7 +13,6 @@ trainingnavtop=true 
  <li><a href="#40">Hide the Status Bar on Android 4.0 and Lower</a></li>

  <li><a href="#41">Hide the Status Bar on Android 4.1 and Higher</a></li>

  <li><a href="#behind">Make Content Appear Behind the Status Bar</a></li>

  <li><a href="#action-bar">Synchronize the Status Bar with Action Bar Transition</a></li>

</ol>



<!-- other docs (NOT javadocs) -->
@@ -102,7 +101,7 @@ your app:</p> 
        super.onCreate(savedInstanceState);

        // If the Android version is lower than Jellybean, use this call to hide

        // the status bar.

        if (Build.VERSION.SDK_INT < 16) {

        if (Build.VERSION.SDK_INT &lt; 16) {

            getWindow().setFlags(WindowManager.LayoutParams.FLAG_FULLSCREEN,

                    WindowManager.LayoutParams.FLAG_FULLSCREEN);

        }
@@ -192,33 +191,3 @@ The {@link android.view.View#fitSystemWindows fitSystemWindows()} method is call 
view hierarchy when the content insets for a window have changed, to allow the window to

adjust its content accordingly. By overriding this method you can handle the

insets (and hence your app's layout) however you want. </p>
 


 <h2 id="action-bar">Synchronize the Status Bar with Action Bar Transition</h2>



  <p>On Android 4.1 and higher, to avoid resizing your layout when the action bar hides and

  shows, you can enable overlay mode for the action bar.

  When in overlay mode, your activity layout uses all the

  space available as if the action bar is not there and the system draws the action bar in

  front of your layout. This obscures some of the layout at the top, but now when the

  action bar hides or appears, the system does not need to resize your layout and the

  transition is seamless.</p>



  <p>To enable overlay mode for the action bar, you need to create a custom theme that

  extends an existing theme with an action bar and set the

  {@code android:windowActionBarOverlay} attribute

  to {@code true}. For more discussion of this topic, see

  <a href="{@docRoot}training/basics/actionbar/overlaying.html#EnableOverlay">

  Overlaying the Action Bar</a> in the <a href="{@docRoot}training/basics/actionbar/index.html">

  Adding the Action Bar</a> class.</p>





<p>Then use

{@link android.view.View#SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN},

as described above,

to set  your activity layout to use the same screen area that's available when you've enabled

{@link android.view.View#SYSTEM_UI_FLAG_FULLSCREEN}.



When you want to hide the system UI, use

{@link android.view.View#SYSTEM_UI_FLAG_FULLSCREEN}.

This also hides the action bar (because {@code windowActionBarOverlay=”true”)} and does

so with a coordinated animation when both hiding and showing the two.</p>