net.rim.blackberry.api.options
Class OptionsManager

java.lang.Object
  net.rim.blackberry.api.options.OptionsManager

public final class OptionsManager
extends Object

Manager for option providers.

To add items to the Options screen, invoke OptionsManager.registerOptionsProvider(net.rim.blackberry.api.options.OptionsProvider) to register as an option provider.

For example: OptionsManager.registerOptionsProvider( new myOptionsProvider());

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 3.6.0, 3.6

Method Summary
	static void	registerOptionsProvider(ExtendedOptionsProvider p) Registers an extended option provider.
	static void	registerOptionsProvider(OptionsProvider optionsProvider) Registers an options provider.

Methods inherited from class java.lang.Object

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

Method Detail

registerOptionsProvider

public static void registerOptionsProvider(OptionsProvider optionsProvider)

Registers an options provider.

Note that registered options providers do not persist past a device reset, so your application should automatically re-register options providers upon startup past a reset.

Parameters:

optionsProvider - Options provider to register.

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 3.6.0

registerOptionsProvider

public static void registerOptionsProvider(ExtendedOptionsProvider p)

Registers an extended option provider.

Registered option providers always appear under the third-party applications category of the Options screen.

Note: Registered option providers do not persist past a device reset. After a reset, you should re-register the option providers.

Parameters:

p - The OptionsProvider to be registered.

Throws:

IllegalArgumentException - if p is null.

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 7.0.0