You can specify the orientation and direction of the Screen in a BlackBerry® device application.

Orientation refers to the Screen aspect ratio, relative to the ground, where the left, right, top, bottom, front, or back of the device are furthest from the ground.

Direction refers to the top of the drawing area of the screen, relative to the location of the BlackBerry logo. If you change the direction that a Screen supports, the change takes effect the next time the Screen orientation of the device changes.

A Screen for a BlackBerry device application can have the following directions and orientations:

Direction

• DIRECTION_NORTH - the top of the drawable area is the screen side closest to the BlackBerry logo
• DIRECTION_WEST - the top of the drawable area is to the left of the logo
• DIRECTION_EAST - the top of the drawable area is to the right of the logo
• DIRECTION_SOUTH - the top of the drawable area is the screen side farthest from the BlackBerry logo

Orientation

• DIRECTION_LANDSCAPE - the top of the drawable area is the screen side farthest from the BlackBerry logo
• DIRECTION_PORTRAIT - the screen is display in protrait view

• Retrieve the orientation of the touch screen
  
• Restrict the touch screen direction
  
• Receive notification when the size of the drawable area of the touch screen changes
  
• Receive notification when the orientation of the touch screen changes