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

Commit 541d1b98 authored by Scott Main's avatar Scott Main
Browse files

cherrypick Change-Id: Ibbbb2a9ba9c4d6c72c8781027850726ba7c548e0 

docs: add new orientation types.
issue 5050865

Change-Id: Idcc557734dbaa4e5631fb7459905cd4bd69a2581
parent ca4cc3cf

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

+40 −13
Original line number Diff line number Diff line
@@ -28,7 +28,9 @@ parent.link=manifest-intro.html 
          android:<a href="#proc">process</a>="<i>string</i>"

          android:<a href="#screen">screenOrientation</a>=["unspecified" | "user" | "behind" |

                                     "landscape" | "portrait" |

                                     "sensor" | "nosensor"]

                                     "reverseLandscape" | "reversePortrait" |

                                     "sensorLandscape" | "sensorPortrait" |

                                     "sensor" | "fullSensor" | "nosensor"]

          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>"
@@ -588,6 +590,13 @@ The value can be any one of the following strings: 
   <td>The default value.  The system chooses the orientation.  The policy it

       uses, and therefore the choices made in specific contexts, may differ 

       from device to device.</td>

</tr><tr>

   <td>"{@code user}"</td>

   <td>The user's current preferred orientation.</td>

</tr><tr>

   <td>"{@code behind}"</td>

   <td>The same orientation as the activity that's immediately beneath it in 

       the activity stack.</td>

</tr><tr>

   <td>"{@code landscape}"</td>

   <td>Landscape orientation (the display is wider than it is tall).</td>
@@ -595,23 +604,41 @@ The value can be any one of the following strings: 
   <td>"{@code portrait}"</td>

   <td>Portrait orientation (the display is taller than it is wide).</td>

</tr><tr>

   <td>"{@code user}"</td>

   <td>The user's current preferred orientation.</td>

   <td>"{@code reverseLandscape}"</td>

   <td>Landscape orientation in the opposite direction from normal landscape.

<em>Added in API level 9.</em></td>

</tr><tr>

   <td>"{@code behind}"</td>

   <td>The same orientation as the activity that's immediately beneath it in 

       the activity stack.</td>

   <td>"{@code reversePortrait}"</td>

   <td>Portrait orientation in the opposite direction from normal portrait.

<em>Added in API level 9.</em></td>

</tr><tr>

   <td>"{@code sensorLandscape}"</td>

   <td>Landscape orientation, but can be either normal or reverse landscape based on the device

sensor.

<em>Added in API level 9.</em></td>

</tr><tr>

   <td>"{@code sensorPortrait}"</td>

   <td>Portrait orientation, but can be either normal or reverse portrait based on the device

sensor.

<em>Added in API level 9.</em></td>

</tr><tr>

   <td>"{@code sensor}"</td>

   <td>The orientation determined by a physical orientation sensor.  The 

       orientation of the display depends on how the user is holding the device; 

       it changes when the user rotates the device.</td>

   <td>The orientation is determined by the device orientation sensor.  The orientation of the

display depends on how the user is holding the device; it changes when the user rotates the

device. Some devices, though, will not rotate to all four possible orientations, by default. To

allow all four orientations, use {@code "fullSensor"}.</td>

</tr><tr>

   <td>"{@code fullSensor}"</td>

   <td>The orientation is determined by the device orientation sensor for any of the 4 orientations.

This is similar to {@code "sensor"} except this allows any of the 4 possible screen orientations,

regardless of what the device will normally do (for example, some devices won't normally use reverse

portrait or reverse landscape, but this enables those). <em>Added in API level 9.</em></td>

</tr><tr>

   <td>"{@code nosensor}"</td>

   <td>An orientation determined without reference to a physical orientation sensor.  

       The sensor is ignored, so the display will not rotate based on how the user 

       moves the device.  Except for this distinction, the system chooses the 

       orientation using the same policy as for the "{@code unspecified}" setting.</td>

   <td>The orientation is determined without reference to a physical orientation sensor.  The sensor

is ignored, so the display will not rotate based on how the user moves the device.  Except for this

distinction, the system chooses the orientation using the same policy as for the "{@code

unspecified}" setting.</td>

</tr>

</table></dd>