SHOW Signed

net.rim.blackberry.api.invoke
Class PhoneArguments

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

public final class PhoneArguments

extends ApplicationArguments

Encapsulates arguments to pass to the Phone application.

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 String

ARG_CALL Argument to open the Phone application for an outgoing call.

Constructor Summary

	PhoneArguments() Creates a new PhoneArgument instance in the default view.
	PhoneArguments(String actionArg, String dialStringArg) Creates a new PhoneArgument instance with dialing string.

Methods inherited from class net.rim.blackberry.api.invoke.ApplicationArguments

getArgs

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

ARG_CALL

public static final String ARG_CALL

Argument to open the Phone application for an outgoing call.

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.

Constructor Detail

PhoneArguments

public PhoneArguments()

Creates a new PhoneArgument instance in the default view.

The default arguments instruct the Phone application to open in the default (recent call list) view.

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.

PhoneArguments

public PhoneArguments(String actionArg,
                      String dialStringArg)

Creates a new PhoneArgument instance with dialing string.

In addition to the traditional "phone number characters" that you would use to compose a phone number (for example, +1-519-888-7465), you can also specify more precise dialing behaviour:

• , : A comma directs the phone application to pause for 2 seconds before proceeding to process the rest of the contents of the dialing string.
• ! : An exclamation mark directs the phone application to wait for user input; the system presents a dialog with three choices:
  - Proceed to dial the rest of the dialing string up to the next comma or exclamation mark
  - Skip directly to the next comma or exlamation mark in the dialing string
  - Cancel the call altogether
• # and * : Generate "pound" and "star" DTMF tones.
• 0 - 9 : Generate numeric DTMF tones.

Parameters:

actionArg - Specify ARG_CALL to open the Phone application and dial the provided dial string.

dialStringArg - Number to dial; this may contain special dialing characters in addition to the components of a traditional phone number.

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.