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

am 700a1f25: Merge "Update resources documentation with new qualifiers." into honeycomb-mr2

Browse Source 
* commit '700a1f25719138b94c453beb6325e627a11a9883':
  Update resources documentation with new qualifiers.
This commit is contained in:
Dianne Hackborn
2011-06-14 11:38:01 -07:00
committed by Android Git Automerger
parent 6c0533f994 700a1f2571
commit 74c48f2b2b
1 changed files with 80 additions and 40 deletions
Download Patch File Download Diff File Expand all files Collapse all files

120
docs/html/guide/topics/resources/providing-resources.jd
View File

@@ -333,6 +333,86 @@ your application for other languages.</p>
indicates the current locale.</p>
</td>
</tr>
<tr id="SmallestScreenWidthQualifier">
<td>Smallest screen width</td>
<td>Examples:<br/>
<code>sw320dp</code><br/>
<code>sw600dp</code><br/>
<code>sw720dp</code><br/>
etc.
</td>
<td>
<p>Specifies a minimum "smallest screen width," in "dp" units, at which the resource
should be used. This configuration value represents the base screen size
of the device, regardless of the orientation of the display. It is based
on the smallest width the application will have in which to perform its
UI layout (in dp units) regardless of the orientation of the screen. The
value here takes into account screen decorations so if the device has some
persistent UI elements on the left or right edge of the display it must
present a value here that is smaller than the real screen size, accounting
for these UI elements reducing the application's available space.</p>
<p>Some values you may use here for common screen sizes:</p>
<ul>
<li>240x320 ldpi (QVGA phone): 320
<li>320x480 mdpi (phone): 320
<li>480x800 hdpi (high density phone): 320
<li>480x800 mdpi (tablet/phone): 480
<li>600x1024 mdpi (7" tablet): 600
<li>720x1280 mdpi (10" tablet): 720
</ul>
<p><em>Added in API Level 13.</em></p>
<p>Also see the {@link android.content.res.Configuration#smallestScreenWidthDp}
configuration field, which holds the current smallest screen width.</p>
</td>
</tr>
<tr id="ScreenWidthQualifier">
<td>Screen width</td>
<td>Examples:<br/>
<code>w720dp</code><br/>
<code>w1024dp</code><br/>
etc.
</td>
<td>
<p>Specifies a minimum screen width, in "dp" units, at which the resource
should be used. This configuration value will change when the orientation
changes between landscape and portrait to match the current actual width.
When multiple screen width configurations are available, the closest to
the current screen width will be used. The
value here takes into account screen decorations so if the device has some
persistent UI elements on the left or right edge of the display it must
present a value here that is smaller than the real screen size, accounting
for these UI elements reducing the application's available space.</p>
<p><em>Added in API Level 13.</em></p>
<p>Also see the {@link android.content.res.Configuration#screenWidthDp}
configuration field, which holds the current screen width.</p>
</td>
</tr>
<tr id="ScreenHeightQualifier">
<td>Screen height</td>
<td>Examples:<br/>
<code>h720dp</code><br/>
<code>h1024dp</code><br/>
etc.
</td>
<td>
<p>Specifies a minimum screen height, in "dp" units, at which the resource
should be used. This configuration value will change when the orientation
changes between landscape and portrait to match the current actual height.
When multiple screen height configurations are available, the closest to
the current screen height will be used. The
value here takes into account screen decorations so if the device has some
persistent UI elements on the left or right edge of the display it must
present a value here that is smaller than the real screen size, accounting
for these UI elements reducing the application's available space. Screen
decorations that are not fixed (such as a phone status bar that can be
hidden when full screen) are <em>not</em> accounted for here, nor are
window decorations like title bar, so applications must be prepared to
deal with a somewhat smaller space than they specify.
<p><em>Added in API Level 13.</em></p>
<p>Also see the {@link android.content.res.Configuration#screenHeightDp}
configuration field, which holds the current screen width.</p>
</td>
</tr>
<tr id="ScreenSizeQualifier">
<td>Screen size</td>
<td>
@@ -392,46 +472,6 @@ is not related to the screen orientation.</p>
which indicates whether the screen is long.</p>
</td>
</tr>
<tr id="ScreenWidthQualifier">
<td>Screen width</td>
<td>Examples:<br/>
<code>w720dp</code><br/>
<code>w1024dp</code><br/>
etc.
</td>
<td>
<p>Specifies a minimum screen width, in "dp" units, at which the resource
should be used. This configuration value will change when the orientation
changes between landscape and portrait to match the current actual width.
When multiple screen width configurations are available, the closest to
the current screen width will be used. The value specified here is
approximate; screen decorations like a status bar or system bar may cause
the actual space available in your UI to be slightly smaller.
<p><em>Added in API Level 13.</em></p>
<p>Also see the {@link android.content.res.Configuration#screenWidthDp}
configuration field, which holds the current screen width.</p>
</td>
</tr>
<tr id="ScreenHeightQualifier">
<td>Screen height</td>
<td>Examples:<br/>
<code>h720dp</code><br/>
<code>h1024dp</code><br/>
etc.
</td>
<td>
<p>Specifies a minimum screen height, in "dp" units, at which the resource
should be used. This configuration value will change when the orientation
changes between landscape and portrait to match the current actual height.
When multiple screen height configurations are available, the closest to
the current screen height will be used. The value specified here is
approximate; screen decorations like a status bar or system bar may cause
the actual space available in your UI to be slightly smaller.
<p><em>Added in API Level 13.</em></p>
<p>Also see the {@link android.content.res.Configuration#screenHeightDp}
configuration field, which holds the current screen width.</p>
</td>
</tr>
<tr id="OrientationQualifier">
<td>Screen orientation</td>
<td>