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 examle, 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" ) )
 

Category:

Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.

Since:

JDE 4.0.0

Field Summary

	static int	APP_TYPE_ADDRESSBOOK Connect to the Address Book application.
	static int	APP_TYPE_CALENDAR Connect to the Calendar 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_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.

Since:

JDE 4.0.0

Category:

Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.

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 clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.

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 clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.

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 clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.

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 clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.

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 clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.

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.

Throws:

IllegalArgumentException - If the application type parameter does not match the type of the application arguments parameter.

Since:

JDE 4.0.0

Category:

Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.