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 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:
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 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.

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 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.
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 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.

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 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.

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 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.



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