SHOW Signed

net.rim.blackberry.api.options
Interface OptionsProvider


public interface OptionsProvider

An application must implement the OptionsProvider interface to add an item to the Options screen. Register by invoking OptionsManager.registerOptionsProvider(OptionsProvider optionsProvider)

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
See Also:
OptionsManager

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

Method Detail

getTitle

public String getTitle()
Retrieves the title to display on the handheld Options screen. In your implementation this method, return a String for the title of your options item.
Returns:
Title for this options item.
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 the 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.

Parameters:
mainScreen - Main screen for the option item.
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.

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.
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-2002 Research In Motion Limited. 295 Phillip Street, Waterloo, Ontario, Canada, N2L 3W8. All Rights Reserved.
Copyright 1993-2000 Sun Microsystems, Inc. 901 San Antonio Road, Palo Alto, California, 94303, U.S.A. All Rights Reserved.
Java is a trademark or registered trademark of Sun Microsystems, Inc. in the US and other countries.