Android/frameworks_base
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: Removed section on overlaying action bar

Browse Source 
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
This commit is contained in:
Andrew Solovay
2016-03-21 14:45:52 -07:00
parent 83a3c67665
commit ea61ca9331
1 changed files with 1 additions and 32 deletions
Download Patch File Download Diff File Expand all files Collapse all files

33
docs/html/training/system-ui/status.jd
View File

@@ -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>