Welcome!

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 BlackBerry Development Advisor on ‎02-12-2010 04:48 PM - edited on ‎09-19-2011 02:13 PM by BlackBerry Development Advisor (11,257 Views)

Summary

 

This article applies to the following:

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

Details

 

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 =
DirectionControl)((Controllable)Display.getDisplay(this)).getControl("net.rim.device.api.lcdui.control.DirectionControl");

int directions = DirectionControl.DIRECTION_EAST | DirectionControl.WEST;

dc.setAcceptableScreenDirections(directions);

 

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;

net.rim.device.api.ui.Ui.getUiEngineInstance().setAcceptableDirections(directions);

 

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

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

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

 

Scott

by Administrator on ‎09-19-2011 02:11 PM

Good catch.  I'll update this now.

Users Online
Currently online: 22 members 1,208 guests
Please welcome our newest community members: