net.rim.blackberry.api.invoke
Class Invoke

java.lang.Object
  extended by 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:
BlackBerry API 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.

See Also:
Constant Field Values
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:
BlackBerry API 4.0.0

APP_TYPE_CALENDAR

public static final int APP_TYPE_CALENDAR
Connect to the Calendar application.

See Also:
Constant Field Values
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:
BlackBerry API 4.0.0

APP_TYPE_MESSAGES

public static final int APP_TYPE_MESSAGES
Connect to the Message application.

See Also:
Constant Field Values
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:
BlackBerry API 4.0.0

APP_TYPE_MEMOPAD

public static final int APP_TYPE_MEMOPAD
Connect to the Memo Pad application.

See Also:
Constant Field Values
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:
BlackBerry API 4.0.0

APP_TYPE_PHONE

public static final int APP_TYPE_PHONE
Connect to the Phone application.

See Also:
Constant Field Values
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:
BlackBerry API 4.0.0

APP_TYPE_TASKS

public static final int APP_TYPE_TASKS
Connect to the Tasks application.

See Also:
Constant Field Values
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:
BlackBerry API 4.0.0

APP_TYPE_CAMERA

public static final int APP_TYPE_CAMERA
Connect to the Camera application

See Also:
Constant Field Values
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:
BlackBerry API 4.2.0

APP_TYPE_MAPS

public static final int APP_TYPE_MAPS
Connect to the BlackBerry Maps application.

See Also:
Constant Field Values
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:
BlackBerry API 4.2.0

APP_TYPE_BLUETOOTH_CONFIG

public static final int APP_TYPE_BLUETOOTH_CONFIG
Connect to the Bluetooth Configuration

See Also:
Constant Field Values
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:
BlackBerry API 4.2.1

APP_TYPE_CALCULATOR

public static final int APP_TYPE_CALCULATOR
Connect to the Calculator application

See Also:
Constant Field Values
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:
BlackBerry API 4.2.1

APP_TYPE_SEARCH

public static final int APP_TYPE_SEARCH
Connect to the Search application

See Also:
Constant Field Values
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:
BlackBerry API 4.2.1


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).
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:
BlackBerry API 4.0.0





Copyright 1999-2010 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. All Rights Reserved.
Copyright 2002-2003 Nokia Corporation All Rights Reserved.
Java is a trademark of Sun Microsystems, Inc.