SHOW Signed

net.rim.blackberry.api.options
Interface OptionsProvider


public interface OptionsProvider

Option providers may add entries into the system's Options screen.

An application must implement this interface to add items to the Options screen; register as a provider with the OptionsManager by invoking registerOptionsProvider.

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:
3.6

Method Summary
 Category: Signed  String getTitle()
          Retrieves the title to place in the Options screen.
 Category: Signed  void populateMainScreen(MainScreen mainScreen)
          Creates the main screen for this option item.
 Category: Signed  void save()
          Saves data for this option item.
 

Method Detail

getTitle

public String getTitle()
Retrieves the title to place in the Options screen.

Sub-classes that implement this method must provide the string the system should place in the Options screen.

Returns:
Title for this options item.
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.

populateMainScreen

public void populateMainScreen(MainScreen mainScreen)
Creates the main screen for this option item.

This screen appears when a user selects your item in the Options screen. In your implementation of this method, add one or more fields to the screen to display options. Any static or class level fields in MainScreen must be removed or a new instance of the field must be instantiated each time this method is called.

Parameters:
mainScreen - Main screen for this option item.
Since:
JDE 4.0.2
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.

save

public void save()
Saves data for this option item.

In your implementation of this method, you should commit the selected values for fields on your option screen to a persistent object.

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.


Copyright 1999-2004 Research In Motion Limited. 295 Phillip Street, Waterloo, Ontario, Canada, N2L 3W8. All Rights Reserved.
Copyright 1993-2003 Sun Microsystems, Inc. 901 San Antonio Road, Palo Alto, California, 94303, U.S.A.
Copyright 2002-2003 Nokia Corporation All Rights Reserved.
Java is a trademark or registered trademark of Sun Microsystems, Inc. in the US and other countries.