|
|||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
| SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||
java.lang.Object | +--net.rim.blackberry.api.mms.MMS
Provides advanced utilities for interaction with the MMS messaging system.
In order to obtain similar functionality for the SMS messaging system use
SMS.
NOTE: Currently when MMS messages are sent by the user from the BlackBerry messaging
application if the MMS SendListeners modify the message those changes are discarded and the
original message is sent. They are, however, still able to forbid the message from being sent by
returning false from sendMessage(). This behaviour is planned to
be fixed in a later release. When MMS messages are sent via
MessageConnection.send(javax.wireless.messaging.Message) then
the MMS send listeners are fully functional and are able to modify the contents of the
message.
| Method Summary | ||
|
static void |
addSendListener(SendListener listener)
Adds a SendListener to the list of MMS send listeners. |
|
static void |
removeSendListener(SendListener listener)
Removes a SendListener from the list of MMS send listeners. |
| Methods inherited from class java.lang.Object |
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
| Method Detail |
public static void addSendListener(SendListener listener)
SendListener to the list of MMS send listeners.
An MMS send listener will be notified prior to MMS messages being added to the send queue.
The listener may modify the message before it is sent or deny it from being sent completely
by returning false from sendMessage(). Any exceptions thrown by
sendMessage() will be silently discarded and will be treated as if the method
returned true.
A listener cannot be present multiple times in the list of listeners. If the specified
listener is present in the current list of listeners then this method does nothing.
Comparison with registered listeners is done using the == operator.
A listener will remain in the list of listeners even after the application exits. That is,
a listener is never automatically removed but is only removed when explicity requested via
removeSendListener(net.rim.blackberry.api.mms.SendListener).
Usage of MMS send listeners can be controlled using the "cross-application communication" application
control (ApplicationPermissions.PERMISSION_CROSS_APPLICATION_COMMUNICATION).
Every invocation of this method checks the application control database and throws
ControlledAccessException if permission is denied. Note that the permissions that
control this method may change over time and therefore it is advisable to still catch and handle
ControlledAccessException even if the application permissions are checked prior to
invoking.
listener - The SendListener to add.NullPointerException - if listener is null.ControlledAccessException - if permissions to modify the list
of send listeners is denied.removeSendListener(SendListener)public static void removeSendListener(SendListener listener)
SendListener from the list of MMS send listeners.
After a SendListener is removed it will no longer be notified when messages
are sent. If the specified listener is not found in the list of listeners then this
method does nothing. Comparison with registered listeners is done using the ==
operator.
Usage of MMS send listeners can be controlled using the "cross-application communication" application
control (ApplicationPermissions.PERMISSION_CROSS_APPLICATION_COMMUNICATION).
Every invocation of this method checks the application control database and throws
ControlledAccessException if permission is denied. Note that the permissions that
control this method may change over time and therefore it is advisable to still catch and handle
ControlledAccessException even if the application permissions are checked prior to
invoking.
listener - The SendListener to remove; if null then
this method does nothing.ControlledAccessException - if permissions to modify the list
of send listeners is denied.addSendListener(SendListener)
|
|||||||||
| 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.