SHOW Signed

net.rim.blackberry.api.mail
Interface AttachmentHandler

public interface AttachmentHandler

An application must implement the AttachmentHandler interface to perform custom attachment actions.

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 Summary

	String	menuString() Defines the menu item to display for this attachment handler.
	void	run(Message m, SupportedAttachmentPart p) Performs custom processing on an attachment.
	boolean	supports(String contentType) Determines whether this attachment handler accepts a specific content type.

Method Detail

supports

public boolean supports(String contentType)

Determines whether this attachment handler accepts a specific content type. This method is invoked when the handheld receives an attachment. Implement this method to register the content type that this attachment handler accepts.

Parameters:

contentType - A MIME content type.

Returns:

True if this handler accepts the specified content type

Since:

JDE 3.6

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.

menuString

public String menuString()

Defines the menu item to display for this attachment handler. This method is invoked when the user selects an attachment in the Messages screen. Implement this method to return the menu item string to display in the Messages screen when the user selects a supported attachment.

Returns:

The menu item string to display in the Messages screen when this attachment is in focus.

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.

run

public void run(Message m,
                SupportedAttachmentPart p)

Performs custom processing on an attachment. This method is invoked when the corresponding menu item is selected in the Messages screen.

Note: This method is invoked on the event thread of the Messages application.

Parameters:

m - The message that contains the attachment.

p - The attachment for this attachment handler to process.

Since:

JDE 3.6

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.