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
 Category: Signed static String ARG_CALL
          Argument to open the Phone application for an outgoing call.
 Category: Signed static String VOICEMAIL
          String representing the device's voicemail number
   
Constructor Summary
 Category: Signed PhoneArguments()
          Creates a new PhoneArgument instance in the default view.
 Category: Signed PhoneArguments(String actionArg, String dialStringArg)
          Creates a new PhoneArgument instance with dialing string.
 Category: Signed PhoneArguments(String actionArg, String dialStringArg, boolean smartDialing)
          Creates a new PhoneArgument instance with dialing string.
 
Method Summary
 
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.

VOICEMAIL

public static final String VOICEMAIL
String representing the device's voicemail number
Since:
JDE 4.1.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.
  • PhoneArguments.VOICEMAIL : Dial the device's voicemail number, as specified by the Phone application Options.
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.

PhoneArguments

public PhoneArguments(String actionArg,
                      String dialStringArg,
                      boolean smartDialing)
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.
  • PhoneArguments.VOICEMAIL : Dial the device's voicemail number, as specified by the Phone application Options.
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.
smartDialing - If true, smart dialing will be enabled.
Since:
JDE 4.2.1
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.


Copyright 1999-2007 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.