Welcome to the official BlackBerry Support Community Forums.

This is your resource to discuss support topics with your peers, and learn from each other.

inside custom component

Java Development

Control the screen orientation

by Retired on ‎02-12-2010 04:48 PM - edited on ‎09-19-2011 02:13 PM by Retired (12,489 Views)



This article applies to the following:

  • BlackBerry® smartphones based on Java® technology running BlackBerry® Device Software 4.7 and later, with accelerometer support



BlackBerry smartphones with accelerometer support, such as the touch screen BlackBerry® Storm™ Series, are capable of changing the display orientation between portrait and landscape mode, depending on how the BlackBerry smartphone is held.


It may be desirable for certain applications to limit the possible orientations. For example, a video player application may need to fix the display orientation to landscape mode.


The screen can be oriented in any of four possible directions: north, south, east and west.


To set the allowable screen orientations, MIDlets should use code similar to the following example, prior to calling Display.setCurrent() from the MIDlet constructor.



DirectionControl dc =

int directions = DirectionControl.DIRECTION_EAST | DirectionControl.WEST;



The above example forces the display into landscape mode.


Connected Limited Device Configuration (CLDC) applications should make the following call before any invocation of UiApplication.pushScreen().



int directions = net.rim.device.api.system.Display.ORIENTATION_PORTRAIT;



In the above example the display is forced into portrait mode once the BlackBerry smartphone user rotates the BlackBerry smartphone.

by Developer
on ‎09-17-2011 03:01 PM

Display.DIRECTION_SOUTH isn't in the API.  Display.DIRECTION_PORTRAIT achieves portrait mode.



by BlackBerry Development Advisor
on ‎09-19-2011 02:11 PM

Good catch.  I'll update this now.

Users Online
Currently online: 34 members 4,215 guests
Recent signins:
Please welcome our newest community members: