|
|||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
| SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||
java.lang.Object
|
+--net.rim.blackberry.api.invoke.ApplicationArguments
|
+--net.rim.blackberry.api.invoke.MessageArguments
Encapsulates arguments to pass to the Message application.
| Field Summary | ||
|
static String |
ARG_DEFAULT
Argument to open the message application the default (main message list) view. |
|
static String |
ARG_NEW
Argument to open the message application to compose a new email |
|
static String |
ARG_NEW_MMS
Argument to open the message application to compose a new MMS message |
|
static String |
ARG_NEW_PIN
Argument to open the message application to compose a new PIN message |
|
static String |
ARG_NEW_SMS
Argument to open the message application to compose a new SMS message |
|
static String |
ARG_SAVED
Argument to open the message application in the saved message list. |
|
static String |
ARG_SEARCH
Argument to open the message application in the message search screen. |
| Constructor Summary | ||
|
MessageArguments()
Creates a new MessageArguments instance with default arguments. |
|
|
MessageArguments(Folder folder)
Creates a new MessageArguments instance which takes a Folder as an argument. |
|
|
MessageArguments(Message message)
Creates a new MessageArguments instance which takes a Message as an argument |
|
|
MessageArguments(String arg)
Creates a new MessageArguments instance with provided arguments. |
|
|
MessageArguments(String arg,
String to,
String subject,
String body)
Creates a new MessageArguments instance with provided arguments |
|
|
MessageArguments(TextMessage textMessage)
Creates a new MessageArguments instance which takes a TextMessage as an
argument. |
|
| 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 |
public static final String ARG_DEFAULT
public static final String ARG_NEW
public static final String ARG_NEW_MMS
public static final String ARG_NEW_PIN
public static final String ARG_NEW_SMS
public static final String ARG_SAVED
public static final String ARG_SEARCH
| Constructor Detail |
public MessageArguments()
The default arguments instruct the Message application to open in the default (main list) view.
public MessageArguments(Folder folder)
Folder as an argument. With the resulting
MessageArguments object the message application will be launched to view the specified folder.folder - The folder you would like to see in the message application.public MessageArguments(Message message)
Message as an argumentmessage - A Message object (PIN or email). With the resulting MessageArguments object
the message application will be launched with the data in the
Message prepopulated in a compose screen, ready to send.public MessageArguments(String arg)
arg - Use ARG_DEFAULT for the default message list.
Use ARG_SAVED to open the saved message list.
Use ARG_SEARCH to open the search message window.
Use ARG_NEW to open the email message compose screen.
Use ARG_NEW_PIN to open the PIN message compose screen.
Use ARG_NEW_SMS to open the SMS message compose screen.
Use ARG_NEW_MMS to open the MMS message compose screen.public MessageArguments(String arg, String to, String subject, String body)
arg - Use ARG_NEW to create a new, simple email message.
Use ARG_NEW_PIN to create a new, simple PIN message.
Quick MMS and SMS are not supported. Use MessageArguments(String)
to create blank MMS and SMS messages, or MessageArguments(javax.wireless.messaging.TextMessage)
to create a populated SMS message.to - The email address for the recipient if ARG_NEW was specified.
The PIN address for the recipient if ARG_NEW_PIN was specified.subject - A subject for the email/PINbody - The email/PIN bodypublic MessageArguments(TextMessage textMessage)
TextMessage as an
argument.
If the recipient address of the specified TextMessage has a destination port specified then when the message composed by the messaging application is sent it will be sent to that port. If the recipients are modified by the user, such as changing the recipient or adding a new one, then all recipients will receive the message at the specified port. If the port number is not valid then it is discarded and the entire string is considered to be the recipient's phone number. The port number is also considered invalid if it is a "reserved port", as defined in JSR 205: Wireless Messaging API 2.0, which extends and enhances JSR 120: Wireless Messaging API. Other validity checks may be performed on the port number, and if found to be invalid then the port number will be considered part of the recipient's phone number, exactly as it is when invalid for other reasons.
For example, if the recipient is "sms://5195551212:1234" then the destination port will be 1234. If the recipient is "sms://5195551212:a1234" then the destination port will be the default port and the recipient's phone number will be considered to be "5195551212:a1234". If the recipient is "sms://5195551212:2805" then the destination port will be the default port and the recipient's phone number will be considered to be "5195551212:2805" because port 2805 is a "reserved" port, as specified in section "A.6.0 Restrictions on Port Numbers for SMS Messages" in Wireless Messaging API (WMA) for Java 2 Micro Edition Version 1.0.2 Final Release (JSR205).
textMessage - A TextMessage object (SMS). With the resulting
MessageArguments object the message application will be launched with the data in the
TextMessage pre-populated in an SMS compose screen, ready to send.
|
|||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
| SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||
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.