Invoke (BlackBerry JDE 7.1.0 API Reference)

Overview

Package

Class

Tree

Deprecated

Index

Help

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

net.rim.blackberry.api.invoke
Class Invoke

java.lang.Object
  net.rim.blackberry.api.invoke.Invoke

public final class Invoke
extends Object
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:

Invoke.invokeApplication( Invoke.APP_TYPE_PHONE, null )

Invoke.invokeApplication( Invoke.APP_TYPE_PHONE, new PhoneArguments() )

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
	`static int`	`APP_TYPE_ADDRESSBOOK` Connect to the Address Book application.
	`static int`	`APP_TYPE_BLUETOOTH_CONFIG` Connect to the Bluetooth Configuration
	`static int`	`APP_TYPE_CALCULATOR` Connect to the Calculator application
	`static int`	`APP_TYPE_CALENDAR` Connect to the Calendar application.
	`static int`	`APP_TYPE_CAMERA` Connect to the Camera application
	`static int`	`APP_TYPE_MAPS` Connect to the BlackBerry Maps application.
	`static int`	`APP_TYPE_MEMOPAD` Connect to the Memo Pad application.
	`static int`	`APP_TYPE_MESSAGES` Connect to the Message application.
	`static int`	`APP_TYPE_PHONE` Connect to the Phone application.
	`static int`	`APP_TYPE_SEARCH` Connect to the Search application
	`static int`	`APP_TYPE_TASKS` Connect to the Tasks application.

Method Summary
	`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