net.rim.device.api.lbs.picker
Interface LocationPicker.Picker

All Known Implementing Classes:
AbstractLocationPicker, ContactsLocationPicker, EnterLocationPicker, GPSLocationPicker, GeotaggedPhotoPicker, MapsLocationPicker, RecentLocationPicker, SuggestedLocationPicker
Enclosing class:
LocationPicker

public static interface LocationPicker.Picker

Interface that defines an individual location picker.

An individual picker must define the following:

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 5.0.0

Method Summary
Category: Signed  void cancelPickLocation()
          Cancels the pick location request.
Category: Signed  String getLocationPickerName()
          Retrieves the name of the location provider to display in the list of individual location pickers.
Category: Signed  boolean isLocationPersistable()
          Defines whether a picked location should persist and be available in the "Recently Selected" RecentLocationPicker.
Category: Signed  void pickLocation(LocationPicker.Listener listener)
          Handles the select location request.
 



Method Detail

pickLocation

void pickLocation(LocationPicker.Listener listener)
Handles the select location request.

Parameters:
listener - The listener to notify when a location is selected.
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 5.0.0

getLocationPickerName

String getLocationPickerName()
Retrieves the name of the location provider to display in the list of individual location pickers.

Returns:
The name to display.
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 5.0.0

isLocationPersistable

boolean isLocationPersistable()
Defines whether a picked location should persist and be available in the "Recently Selected" RecentLocationPicker.

Returns:
true if the selected location should persist, false otherwise.
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 5.0.0

cancelPickLocation

void cancelPickLocation()
Cancels the pick location request.

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 5.0.0





Copyright 1999-2011 Research In Motion Limited. 295 Phillip Street, Waterloo, Ontario, Canada, N2L 3W8. All Rights Reserved.
Java is a trademark of Oracle America Inc. in the US and other countries.
Legal