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

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

public static interface LocationPicker.Picker

Interface that defines a individual location picker

An individual picker must define:

Since:
BlackBerry API 5.0.0

Method Summary
 void cancelPickLocation()
          Cancel the pick location request
 String getLocationPickerName()
          Name of location provider to display in the list of individual location pickers
 boolean isLocationPersistable()
          Define whether a location picked should be persisted and available in the "Recently Selected" RecentLocationPicker.
 void pickLocation(LocationPicker.Listener listener)
          Handle the pick location request Generate a Landmark (i.e.
 



Method Detail

pickLocation

void pickLocation(LocationPicker.Listener listener)
Handle the pick location request
  1. Generate a Landmark (i.e. Prompt the user, Programatically, etc.)
  2. Notify the Listener by invoking the LocationPicker.Listener locationPicked(LocationPicker.Picker picker, Landmark location) method.

Parameters:
listener - Listener to notify when a location has been picked
Since:
BlackBerry API 5.0.0

getLocationPickerName

String getLocationPickerName()
Name of location provider to display in the list of individual location pickers

Returns:
The name to display
Since:
BlackBerry API 5.0.0

isLocationPersistable

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

Returns:
true the picked location will be persisted.
Since:
BlackBerry API 5.0.0

cancelPickLocation

void cancelPickLocation()
Cancel the pick location request

Since:
BlackBerry API 5.0.0





Copyright 1999-2010 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. All Rights Reserved.
Copyright 2002-2003 Nokia Corporation All Rights Reserved.
Java is a trademark of Sun Microsystems, Inc.