net.rim.device.api.applicationcontrol
Interface ReasonProvider

public interface ReasonProvider

Allows an application to provide a String to the system for inclusion in the permission request dialog.

See Also:

ApplicationPermissionsManager

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.5.0

Method Summary
	String	getMessage(int permissionID) Get the message of this listener according to the type of permission.

Method Detail

getMessage

String getMessage(int permissionID)

Get the message of this listener according to the type of permission.

Parameters:

permissionID - Type of permission which triggered the request; valid values are any of the ApplicationPermissions#PERMISSION_ constants.

Returns:

A user friendly message from the listener describing the reason behind the permissions request or null if no message is to be provided or an uncaught exception is thrown.

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.5.0