|
|||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||
public interface ApplicationMessageFolderListener
Folder listener that is notified when the user has manipulated one or more application messages in the Messages application. The constants in this interface represent the user actions that trigger a notification.
If the callback notification indicates that more than one application message has been manipulated,
the application should call ApplicationMessageFolder.fireReset()
instead of individual fire calls
(such as fireElementAdded() and fireElementRemoved())
for better performance.
| Field Summary | ||
|---|---|---|
|
static int |
MESSAGES_MARKED_OLD
Performed when the user opens the global message list and views partial message information. |
|
static int |
MESSAGE_DELETED
Performed when the user manually deletes messages from the list by pressing the Delete key or through a context menu. |
|
static int |
MESSAGE_MARKED_OPENED
Performed when the user manually marks selected messages as opened. |
|
static int |
MESSAGE_MARKED_UNOPENED
Performed when the user manually marks selected messages as unopened. |
| Method Summary | ||
|---|---|---|
|
void |
actionPerformed(int action,
ApplicationMessage[] messages,
ApplicationMessageFolder folder)
Called when an action is performed on an ApplicationMessageFolder. |
| Field Detail |
|---|
static final int MESSAGE_DELETED
ApplicationMessageFolder.fireElementRemoved(ApplicationMessage)
method.
static final int MESSAGE_MARKED_OPENED
static final int MESSAGE_MARKED_UNOPENED
static final int MESSAGES_MARKED_OLD
Note that no messages are passed in the second method parameter of
ApplicationMessageFolderListener.actionPerformed(int, ApplicationMessage[], ApplicationMessageFolder) method.
The array will be empty.
ApplicationMessageFolder.fireElementAdded(ApplicationMessage, boolean),
Constant Field Values| Method Detail |
|---|
void actionPerformed(int action,
ApplicationMessage[] messages,
ApplicationMessageFolder folder)
ApplicationMessageFolder. The
method executes in the application's environment asynchronously after the
given action has been performed. If the array of messages contains more
than one element, the application should call
ApplicationMessageFolder.fireReset() instead of making individual fire method calls
that represent individual changes.
If a message was deleted by the user and the folder listener was called back with the
ApplicationMessageFolderListener.MESSAGE_DELETED action, there is no need to fire
notifications on the folder through ApplicationMessageFolder.fireElementRemoved(ApplicationMessage).
action - Action code specified by one of the constants in this
interface.messages - An underlying message or an array of messages if a bulk
operation.folder - Folder that contains the message(s).
|
|||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||
Copyright 1999-2011 Research In Motion Limited. 295 Phillip Street, Waterloo, Ontario, Canada, N2L 3W8. All Rights Reserved.
Java is a trademark of Oracle America Inc. in the US and other countries.
Legal