SHOW Signed

net.rim.blackberry.api.mail.event
Class MessageEvent

java.lang.Object
  |
  +--net.rim.blackberry.api.mail.event.MailEvent
        |
        +--net.rim.blackberry.api.mail.event.MessageEvent

public class MessageEvent

extends MailEvent

Indicates that a message has changed.

A MessageEvent is delivered when a message body, headers or flags change.

Note: It is not possible to intercept a message during transmission. Changes to the Message object that are indicated by the MessageEvent do not change data that has already been sent from the handheld. Changes are reflected in the message in the messages list, however, and the updated message can be retransmitted.

Category:

Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.

Since:

JDE 3.6.0

See Also:

Message

Field Summary

static int

UPDATED Message header attributes (envelope) changed, but not the message body.

Fields inherited from class net.rim.blackberry.api.mail.event.MailEvent

_source

Constructor Summary

MessageEvent(int type, Message msg) Constructor.

Method Summary

	void	dispatch(Object listener) Invokes the appropriate method on a listener for this event.
	Message	getMessage() Returns the changed Message.
	int	getMessageChangeType() Returns the type of this event.

Methods inherited from class net.rim.blackberry.api.mail.event.MailEvent

getSource, toString

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

UPDATED

public static final int UPDATED

Message header attributes (envelope) changed, but not the message body.

Since:

JDE 3.6.0

Category:

Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.

Constructor Detail

MessageEvent

public MessageEvent(int type,
                    Message msg)

Constructor.

Since:

JDE 3.6.0

Category:

Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.

Method Detail

dispatch

public void dispatch(Object listener)

Description copied from class: MailEvent

Invokes the appropriate method on a listener for this event.

Subclasses provide the implementation.

Overrides:

dispatch in class MailEvent

Since:

JDE 3.7.0

Category:

Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.

getMessage

public Message getMessage()

Returns the changed Message.

Since:

JDE 3.6.0

Category:

Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.

getMessageChangeType

public int getMessageChangeType()

Returns the type of this event.

Since:

JDE 3.6.0

Category:

Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.