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

Testing and Deployment

Compatibility mode on touch screen BlackBerry smartphones

by Retired ‎02-16-2010 12:09 PM - edited ‎02-17-2010 04:30 PM (2,959 Views)


This article applies to the following:

  • BlackBerry® smartphones with touch screen functionality
  • BlackBerry® Storm™ smartphone


Compatibility mode is used when the application has been designed for a physical input (non-touch screen) BlackBerry smartphone, where the application expects to receive input events from the keyboard and the trackball.

There are three ways that your application can indicate whether it should be running in compatibility mode:

  1. If the application is compiled with BlackBerry® Java® Development Environment (BlackBerry JDE) 4.7 or later, it will automatically not run in compatibility mode. If the application is compiled with any earlier version of the BlackBerry JDE, it will run in compatibility mode.
  2. You can add fields to your Java Application Descriptor (JAD) file for wireless downloading to indicate whether you want the application to run in compatibility mode regardless of what BlackBerry JDE version was used to compile the application. You can also use a field to indicate whether the BlackBerry smartphone user can modify this capability. In the following example, the value can be set to either true or false.

    RIM-TouchCompatibilityMode: value
    RIM-TouchCompatibilityMode-UserChangeable: value


  3. The BlackBerry smartphone user can modify settings on the BlackBerry smartphone so that the application runs in compatibility mode. This is done by completing the following steps on the BlackBerry smartphone:
    1. Go to Options > Advanced Options > Applications.
    2. From the list of applications, select the appropriate application.
    3. Display the menu, and then turn on enable or disable for the compatibility mode.
  4. If your application is running in compatibility mode, it will always have a virtual keyboard, it will always be locked to portrait mode, and it will always translate touch events into trackball or keyboard events.

Users Online
Currently online: 14 members 1,669 guests
Please welcome our newest community members: