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

Commit 084369fb authored by Scott Main's avatar Scott Main
Browse files

docs: add uiOptions attribute to manifest docs 

Change-Id: Ibe2960b6a4ee4e2d4a47e4acc7c197d68702d1e6
parent cd3ec73f

docs/html/guide/topics/manifest/activity-element.jd

+28 −2
Original line number Diff line number Diff line
@@ -34,6 +34,7 @@ parent.link=manifest-intro.html 
          android:<a href="#state">stateNotNeeded</a>=["true" | "false"]

          android:<a href="#aff">taskAffinity</a>="<i>string</i>"

          android:<a href="#theme">theme</a>="<i>resource or theme</i>"

          android:<a href="#uioptions">uiOptions</a>=["none" | "splitActionBarWhenNarrow"]

          android:<a href="#wsoft">windowSoftInputMode</a>=["stateUnspecified",

                                       "stateUnchanged", "stateHidden",

                                       "stateAlwaysHidden", "stateVisible",
@@ -749,14 +750,39 @@ match what the activity actually looks like). 


<p>

If this attribute is not set, the activity inherits the theme set for the 

application as a whole &mdash; see the 

application as a whole &mdash; from the 

<code><a href="{@docRoot}guide/topics/manifest/application-element.html">&lt;application&gt;</a></code> 

element's 

<code><a href="{@docRoot}guide/topics/manifest/application-element.html#theme">theme</a></code> 

attribute.  If that attribute is also not set, the default system theme is used.

attribute.  If that attribute is also not set, the default system theme is used. For more

information, see the <a

href="{@docRoot}guide/topics/ui/themes.html">Styles and Themes</a> developer guide.

</p>

<dd>



<!-- ##api level 14## -->

<dt><a name="uioptions"></a>{@code android:uiOptions}</dt>

<dd>Extra options for an activity's UI.

  <p>Must be one of the following values.</p>



  <table>

    <tr><th>Value</th><th>Description</th></tr>

    <tr><td>{@code "none"}</td><td>No extra UI options. This is the default.</td></tr>

    <tr><td>{@code "splitActionBarWhenNarrow"}</td><td>Add a bar at

the bottom of the screen to display action items in the {@link android.app.ActionBar}, when

constrained for horizontal space (such as when in portrait mode on a handset). Instead of a small

number of action items appearing in the action bar at the top of the screen, the action bar is

split into the top navigation section and the bottom bar for action items. This ensures a reasonable

amount of space is made available not only for the action items, but also for navigation and title

elements at the top. Menu items are not split across the two bars; they always appear

together.</td></tr>

  </table>

  <p>For more information about the action bar, see the <a

href="{@docRoot}guide/topics/ui/actionbar.html">Action Bar</a> developer guide.</p>

  <p>This attribute was added in API level 14.</p>

</dd>





<!-- ##api level 3## -->

<dt><a name="wsoft"></a>{@code android:windowSoftInputMode}</dt>

<dd>How the main window of the activity interacts with the window containing

docs/html/guide/topics/manifest/application-element.jd

+27 −2
Original line number Diff line number Diff line
@@ -23,7 +23,8 @@ parent.link=manifest-intro.html 
             android:<a href="#proc">process</a>="<i>string</i>"

             android:<a href="#restoreany">restoreAnyVersion</a>=["true" | "false"]

             android:<a href="#aff">taskAffinity</a>="<i>string</i>"

             android:<a href="#theme">theme</a>="<i>resource or theme</i>" &gt;

             android:<a href="#theme">theme</a>="<i>resource or theme</i>"

             android:<a href="#uioptions">uiOptions</a>=["none" | "splitActionBarWhenNarrow"] &gt;

    . . .

&lt;/application&gt;</pre></dd>
@@ -276,7 +277,31 @@ set by the 
<dd>A reference to a style resource defining a default theme for all

activities in the application.  Individual activities can override

the default by setting their own <code><a href="{@docRoot}guide/topics/manifest/activity-element.html#theme">theme</a></code> 

attributes; see that attribute for more information.</dd>

attributes. For more information, see the <a

href="{@docRoot}guide/topics/ui/themes.html">Styles and Themes</a> developer guide.

</dd>



<!-- ##api level 14## -->

<dt><a name="uioptions"></a>{@code android:uiOptions}</dt>

<dd>Extra options for an activity's UI.

  <p>Must be one of the following values.</p>



  <table>

    <tr><th>Value</th><th>Description</th></tr>

    <tr><td>{@code "none"}</td><td>No extra UI options. This is the default.</td></tr>

    <tr><td>{@code "splitActionBarWhenNarrow"}</td><td>Add a bar at

the bottom of the screen to display action items in the {@link android.app.ActionBar}, when

constrained for horizontal space (such as when in portrait mode on a handset). Instead of a small

number of action items appearing in the action bar at the top of the screen, the action bar is

split into the top navigation section and the bottom bar for action items. This ensures a reasonable

amount of space is made available not only for the action items, but also for navigation and title

elements at the top. Menu items are not split across the two bars; they always appear

together.</td></tr>

  </table>

  <p>For more information about the action bar, see the <a

href="{@docRoot}guide/topics/ui/actionbar.html">Action Bar</a> developer guide.</p>

  <p>This attribute was added in API level 14.</p>

</dd>



</dl></dd>