Would you like to tell us how we are doing?

You bet No thanks

Sorry about the red box, but we really need you to update your browser. Read this excellent article if you're wondering why we are no longer supporting this browser version. Go to Browse Happy for browser suggestions and how to update.

Using the BlackBerry Smartphone Simulator

Simulate touch screen input

When you simulate input for a touch screen BlackBerry device on the BlackBerry Smartphone Simulator all commands use the mouse.

Gesture to simulate

BlackBerry Device Software versions

Steps

Click the screen.

4.71 to 5.1.

Move the pointer to the simulated screen and click the left mouse button.

Drag a finger.

4.7.1 and later.

  1. On the simulated screen, click either mouse button down and hold it.
  2. Move the pointer.
  3. Release the mouse button.

Swipe across the screen.

4.7.1 and later.

  1. Click and hold the left or right mouse button.
  2. Quickly move the pointer in the desired direction.
  3. Release the mouse button.

Tap the screen.

6.0 and later.

With the left or right mouse button, click a spot on the simulated screen.

Double-tap the screen.

6.0 and later.

With the left or right mouse button, double-click a spot of the simulated screen.

Pinch open or pinch closed.

4.7.1 and later.

  1. On the Simulate menu, click Multitouch Mode.
  2. With the left or right mouse button, click and drag anywhere within the simulated screen area.
  3. Perform the same action elsewhere on the screen.

After you complete the second action, both touches are simulated as if they were done at the same time.

Touch the screen.

4.71 to 5.1.

Click with the right mouse button on the simulated screen.

Touch and hold screen.

6.0 and later.

  1. On the simulated screen, click the left or right mouse button and hold it.
  2. Release the mouse button.

Touch an item.

4.71 to 5.1.

Right-click the mouse button on the item.

Touch the screen in two locations at the same time.

4.7.1 and later.

  1. On the Simulate menu, click Multitouch Mode.
  2. With the left or right mouse button, click anywhere within the simulated screen area.
  3. Perform the same action elsewhere on the screen.

After you complete the second action, both touches are simulated as if they were done at the same time.

Send input from the computer

Action

Keyboard mapping

Use the trackpad in an application.

  1. Press F12 to activate the trackpad.
  2. Move your mouse over the BlackBerry Smartphone Simulator window.
  3. Move your mouse in the direction you want to scroll.
To deactivate the trackpad, press F12 again.

Perform a trackpad click.

Make sure that you have activated the trackpad, then press F9 or click the wheel on your mouse.

Navigate the Home screen.

Press UP or DOWN, or roll the scroll wheel on your mouse.

Use the Back button.

Press the ESC key, or right-click with your mouse.

Type.

Use the keyboard.

Increase the volume.

Press PLUS SIGN.

Decrease the volume.

Press MINUS SIGN.

Access the Phone application.

Press PGUP.

End a phone call.

Press END.

Use alternate characters.

Press CTRL.

Mute the smartphone.

Press F7 to toggle between muted and unmuted.

Lock the smartphone.

Press F6 to toggle between locked and unlocked.

Insert a currency symbol.

Press F5.

Simulate trackball input

On a BlackBerry Smartphone Simulator for a BlackBerry device with a trackball, you can use a keyboard and mouse to simulate BlackBerry device functionality. Note that rolling the mouse wheel does not generate trackball rolls.

Input

Keyboard

Mouse with trackball mode on

Mouse with trackball mode off

Turn trackball mode on or off.

Press F12.

  1. On the Edit menu, click Map Middle Mouse Button > Toggle Trackball Mode.
  2. Click the middle mouse button.
  1. On the Edit menu, click Map Middle Mouse Button > Toggle Trackball Mode.
  2. Click the middle mouse button.

Click the trackball.

Press F9.

Click the left mouse button.

On the trackball in the simulator, click the middle mouse button.

Roll the trackball.

Press the arrow keys.

Move the mouse.

On the trackball in the simulator, click and drag the mouse.

Press the Escape button.

Press ESC.

Click the right mouse button.

On the trackball in the simulator, click the right mouse button.

Simulate trackwheel input

The BlackBerry Smartphone Simulator assigns BlackBerry device functionality to the following computer keyboard and mouse procedures.

Some procedures are not supported on all BlackBerry devices.

Input

Keyboard

Mouse

Roll the trackwheel.

Press the UP ARROW or DOWN ARROW key.

Roll the mouse wheel button.

Click the trackwheel.

Press the LEFT ARROW key.

Click the mouse wheel button.

Press the Escape key.

Press ESC or the RIGHT ARROW key.

Click the right mouse button.

Turn on BlackBerry device backlighting.

Press PAGE DOWN.

Click the Power button on the BlackBerry Smartphone Simulator keyboard.

Press the Symbol key.

Press DELETE.

Click the Symbol key on the BlackBerry Smartphone Simulator keyboard.

Press the Alt key.

Press CTRL.

Click the Alt key on the BlackBerry Smartphone Simulator keyboard.

Press the BlackBerry device keys.

Press the keys on your computer keyboard.

Click the keys on the BlackBerry Smartphone Simulator keyboard.

Press the phone/PTT (Push to Talk) button.

Press PAGE UP.

Simulate convenience and multi-function keys

Some keys that are present on BlackBerry devices are not present on computer keyboards. The BlackBerry Smartphone Simulator uses other keyboard keys to represent those BlackBerry keys.

Task

Steps

Front Convenience key.

Press INSERT.

Convenience key.

Press PAGE UP.

Currency symbol key.

Press F5.

Speaker phone key.

Press F6.

Simulate a multi-function key

Some keys that are present on BlackBerry devices are not present on computer keyboards. The BlackBerry Smartphone Simulator uses other keyboard keys to represent those BlackBerry device keys.

Task

Steps

Front Convenience key.

  1. Press I.

Menu key.

  1. Press INSERT.

Right Side Convenience key.

  1. Press \.

Left Side Convenience key.

  1. Press PAGE UP.

Volume Up key.

  1. Press F8.

Volume Down key.

  1. Press F7.

Changing the BlackBerry smartphone orientation

BlackBerry smartphones with touch screens support displaying screen information in either landscape or portrait mode, depending on how the physical smartphone is oriented.

Orientation mode

Description

Top-Side-Up

The smartphone is oriented normally.

Left-Side-Up

The smartphone is rotated 90 degrees to the right.

Right-Side-Up

The smartphone is rotated 90 degrees to the left.

Bottom-Side-Up

The smartphone is rotated 180 degrees, upside-down.

Front-Side-Up

The smartphone screen is facing upward.

Back-Side-Up

The smartphone screen is facing downward.

Change screen orientation

Use the BlackBerry Smartphone Simulator to simulate a screen orientation change.
  1. On the Simulate menu, click Tilt BlackBerry.
  2. Select an orientation mode for the BlackBerry screen.

Simulate tilting a BlackBerry device in 3-D space

Before you begin:

Verify that you have the following components installed on your computer:

  • video card that supports OpenGL 1.1 or later
  • BlackBerry Smartphone Simulator 2.13 or later for a BlackBerry device with an accelerometer
You can use the tilt feature to view the rotation and tilt of a BlackBerry device in 3-D space.
  1. On the Simulate menu, click Tilt BlackBerry.
  2. Place the mouse pointer at a corner of the device. The mouse pointer changes to an image of a device.
  3. To rotate and tilt the device, press and hold the left mouse button while moving the mouse.
  4. To stop rotating and tilting the device, release the mouse button.

View the event log

The event log window displays information about events that occur between a simulated BlackBerry smartphone and its environment. The BlackBerry Smartphone Simulator logs event messages for events, including when you simulate playing audio files, placing a phone call, and blinking the light.
On the Tools menu, click Show Event Log.

View messages from the JVM

The BlackBerry Smartphone Simulator can display the standard.out and standard.err streams of messages that the BlackBerry Java Virtual Machine sends.
On the Tools menu, click Show Output Log.