|
|||||||||
| 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 similiar functionality for the SMS messaging system use
SMS.
| 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().
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-2008 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.