net.rim.blackberry.api.sms
Interface SendListener

public interface SendListener

A listener that can be notified prior to SMS messages being sent.

A SendListener can be registered and unregistered via SMS.addSendListener(SendListener) and SMS.removeSendListener(SendListener), respectively. See the javadocs for these methods for details of how SMS send listeners can be used.

Category:

Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.

Since:

BlackBerry API 4.6.0

Method Summary
	boolean	sendMessage(Message message) This method is called just before the SMS message is added to the queue for sending.

Method Detail

sendMessage

boolean sendMessage(Message message)

This method is called just before the SMS message is added to the queue for sending.

Parameters:

message - the message to be sent; may be modified to change the message that is sent.

Returns:

true if the message should be sent, false otherwise, in which case the message will not be sent and will have a "red X" beside it in the message list.

Category:

Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.

Since:

BlackBerry API 4.6.0