SHOW Signed
 

net.rim.blackberry.api.invoke
Class Invoke

java.lang.Object
  |
  +--net.rim.blackberry.api.invoke.Invoke

public final class Invoke
extends Object

Used to invoke internal applications with optional parameters.

For example, to invoke the phone application and initiate an outgoing call, you can use code similar to this:

   Invoke.invokeApplication( Invoke.APP_TYPE_PHONE, new PhoneArguments( PhoneArguments.ARG_CALL, "555-5555" ) )
 
Note that null can always be used in place of an ApplicationArguments object when invoking the invokeApplication() method. This has the same effect as passing in a corresponding ApplicationArguments object created with the default constructor. For example, the following two method calls are equivalent:
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.

Since:
JDE 4.0.0

Field Summary
 Category: Signed static int APP_TYPE_ADDRESSBOOK
          Connect to the Address Book application.
 Category: Signed static int APP_TYPE_BLUETOOTH_CONFIG
          Connect to the Bluetooth Configuration
 Category: Signed static int APP_TYPE_CALCULATOR
          Connect to the Calculator application
 Category: Signed static int APP_TYPE_CALENDAR
          Connect to the Calendar application.
 Category: Signed static int APP_TYPE_CAMERA
          Connect to the Camera application
 Category: Signed static int APP_TYPE_MAPS
          Connect to the BlackBerry Maps application.
 Category: Signed static int APP_TYPE_MEMOPAD
          Connect to the Memo Pad application.
 Category: Signed static int APP_TYPE_MESSAGES
          Connect to the Message application.
 Category: Signed static int APP_TYPE_PHONE
          Connect to the Phone application.
 Category: Signed static int APP_TYPE_SEARCH
          Connect to the Search application
 Category: Signed static int APP_TYPE_TASKS
          Connect to the Tasks application.
 
Method Summary
 Category: Signed static void invokeApplication(int appType, ApplicationArguments args)
          Invokes an internal application.
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

APP_TYPE_ADDRESSBOOK

public static final int APP_TYPE_ADDRESSBOOK
Connect to the Address Book application.
Since:
JDE 4.0.0
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.

APP_TYPE_BLUETOOTH_CONFIG

public static final int APP_TYPE_BLUETOOTH_CONFIG
Connect to the Bluetooth Configuration
Since:
JDE 4.2.1
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.

APP_TYPE_CALCULATOR

public static final int APP_TYPE_CALCULATOR
Connect to the Calculator application
Since:
JDE 4.2.1
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.

APP_TYPE_CALENDAR

public static final int APP_TYPE_CALENDAR
Connect to the Calendar application.
Since:
JDE 4.0.0
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.

APP_TYPE_CAMERA

public static final int APP_TYPE_CAMERA
Connect to the Camera application
Since:
JDE 4.2.0
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.

APP_TYPE_MAPS

public static final int APP_TYPE_MAPS
Connect to the BlackBerry Maps application.
Since:
JDE 4.2.0
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.

APP_TYPE_MEMOPAD

public static final int APP_TYPE_MEMOPAD
Connect to the Memo Pad application.
Since:
JDE 4.0.0
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.

APP_TYPE_MESSAGES

public static final int APP_TYPE_MESSAGES
Connect to the Message application.
Since:
JDE 4.0.0
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.

APP_TYPE_PHONE

public static final int APP_TYPE_PHONE
Connect to the Phone application.
Since:
JDE 4.0.0
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.

APP_TYPE_SEARCH

public static final int APP_TYPE_SEARCH
Connect to the Search application
Since:
JDE 4.2.1
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.

APP_TYPE_TASKS

public static final int APP_TYPE_TASKS
Connect to the Tasks application.
Since:
JDE 4.0.0
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
Method Detail

invokeApplication

public static void invokeApplication(int appType,
                                     ApplicationArguments args)
Invokes an internal application.
Parameters:
appType - Application to connect to; must be one of the APP_TYPE_* constants.
args - The particular ApplicationArguments sub-class corresponding to the contacted application, or null if default arguments are to be used.
Throws:
IllegalArgumentException - If the application type parameter does not match the type of the application arguments parameter or if any other arguments are incorrect (e.g., trying to view a non-existant PIM item).
Since:
JDE 4.0.0
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.



Copyright 1999-2009 Research In Motion Limited. 295 Phillip Street, Waterloo, Ontario, Canada, N2L 3W8. All Rights Reserved.
Copyright 1993-2003 Sun Microsystems, Inc. 901 San Antonio Road, Palo Alto, California, 94303, U.S.A.
Copyright 2002-2003 Nokia Corporation All Rights Reserved.
Java is a trademark or registered trademark of Sun Microsystems, Inc. in the US and other countries.