cherrypick Change-Id: I8c52dbe5ac04dfeb1b466b163ae3aec5dc401175

docs: update supports-screens doc with xlargescreens attribute...
we updated the Supporting Multiple Screens document with this attribute
for gingerbread, but this document was not updated at that time.

Change-Id: I946e7eb8b93cee1a7223d400c882f415d6045815
This commit is contained in:
Scott Main
2011-01-18 14:50:19 -08:00
parent edc2aac7bf
commit 77d6fcff7b

View File

@@ -9,6 +9,7 @@ page.title=<supports-screens>
&lt;supports-screens android:<a href="#small">smallScreens</a>=["true" | "false"] &lt;supports-screens android:<a href="#small">smallScreens</a>=["true" | "false"]
android:<a href="#normal">normalScreens</a>=["true" | "false"] android:<a href="#normal">normalScreens</a>=["true" | "false"]
android:<a href="#large">largeScreens</a>=["true" | "false"] android:<a href="#large">largeScreens</a>=["true" | "false"]
android:<a href="#xlarge">xlargeScreens</a>=["true" | "false"]
android:<a href="#any">anyDensity</a>=["true" | "false"] /&gt; android:<a href="#any">anyDensity</a>=["true" | "false"] /&gt;
</pre> </pre>
</dd> </dd>
@@ -31,7 +32,7 @@ or scale them up by a factor of 1.5 (high dpi screens).
The screen density is expressed as dots-per-inch (dpi).</p> The screen density is expressed as dots-per-inch (dpi).</p>
<p>For more information, see <p>For more information, see
<a href="{@docRoot}guide/practices/screens_support.html">Multiple Screens Support</a>.</p> <a href="{@docRoot}guide/practices/screens_support.html">Supporting Multiple Screens</a>.</p>
<dt>attributes:</dt> <dt>attributes:</dt>
@@ -43,8 +44,10 @@ The screen density is expressed as dots-per-inch (dpi).</p>
the "normal" (traditional HVGA) screen. An application that does the "normal" (traditional HVGA) screen. An application that does
not support small screens <em>will not be available</em> for not support small screens <em>will not be available</em> for
small screen devices, because there is little the platform can do small screen devices, because there is little the platform can do
to make such an application work on a smaller screen. Applications using to make such an application work on a smaller screen. If the application has set the <a
API Level 4 or higher default this to "true", others are "false". href="{@docRoot}guide/topics/manifest/uses-sdk-element.html">{@code &lt;uses-sdk&gt;}</a> element's
{@code android:minSdkVersion} or {@code android:targetSdkVersion} attribute to "4" or higher,
the default value for this is "true", any value less than "4" results in this set to "false".
</dd> </dd>
<dt><a name="normal"></a>{@code android:normalScreens}</dt> <dt><a name="normal"></a>{@code android:normalScreens}</dt>
@@ -60,15 +63,33 @@ The screen density is expressed as dots-per-inch (dpi).</p>
A large screen is defined as a screen that is significantly larger A large screen is defined as a screen that is significantly larger
than a "normal" phone screen, and thus may require some special care than a "normal" phone screen, and thus may require some special care
on the application's part to make good use of it. An application that on the application's part to make good use of it. An application that
does not support large screens will be placed as a "postage stamp" on does not support large screens (declares this "false")&mdash;but does support "normal" or
such a screen, so that it retains the dimensions it was originally "small" screens&mdash;will be placed as a "postage stamp" on
designed for. Applications using API Level 4 or higher default a large screen, so that it retains the dimensions it was originally
to "true", others are "false". designed for. If the application has set the <a
href="{@docRoot}guide/topics/manifest/uses-sdk-element.html">{@code &lt;uses-sdk&gt;}</a> element's
{@code android:minSdkVersion} or {@code android:targetSdkVersion} attribute to "4" or higher,
the default value for this is "true", any value less than "4" results in this set to "false".
</dd>
<dt><a name="xlarge"></a>{@code android:xlargeScreens}</dt>
<dd>Indicates whether the application supports extra large screen form-factors.
An xlarge screen is defined as a screen that is significantly larger
than a "large" screen, such as a tablet (or something larger) and may require special care
on the application's part to make good use of it. An application that
does not support xlarge screens (declares this "false")&mdash;but does support "large",
"normal", or "small" screens&mdash;will be placed as a "postage stamp" on
an xlarge screen, so that it retains the dimensions it was originally
designed for. If the application has set the <a
href="{@docRoot}guide/topics/manifest/uses-sdk-element.html">{@code &lt;uses-sdk&gt;}</a> element's
{@code android:minSdkVersion} or {@code android:targetSdkVersion} attribute to "4" or higher,
the default value for this is "true", any value less than "4" results in this set to "false".
<p>This attribute was introduced in API Level 9.</p>
</dd> </dd>
<dt><a name="any"></a>{@code android:anyDensity}</dt> <dt><a name="any"></a>{@code android:anyDensity}</dt>
<dd>Indicates whether the application can accommodate any screen <dd>Indicates whether the application includes resources to accommodate any screen
density. Older applications (pre API Level 4) are assumed unable to density. Older applications (before API Level 4) are assumed unable to
accomodate all densities and this is "false" by default. Applications using accomodate all densities and this is "false" by default. Applications using
API Level 4 or higher are assumed able to and this is "true" by default. API Level 4 or higher are assumed able to and this is "true" by default.
You can explicitly supply your abilities here. You can explicitly supply your abilities here.
@@ -84,7 +105,8 @@ The screen density is expressed as dots-per-inch (dpi).</p>
<dt>see also:</dt> <dt>see also:</dt>
<dd> <dd>
<ul> <ul>
<li><a href="{@docRoot}guide/practices/screens_support.html">Multiple Screens Support</a></li> <li><a href="{@docRoot}guide/practices/screens_support.html">Supporting Multiple
Screens</a></li>
<li>{@link android.util.DisplayMetrics}</li> <li>{@link android.util.DisplayMetrics}</li>
</ul> </ul>
</dd> </dd>