|
|||||||||
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 ValuesMethod 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-2010 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. All Rights Reserved.
Copyright 2002-2003 Nokia Corporation All Rights Reserved.
Java is a trademark of Sun Microsystems, Inc.