AbstractListOverlay

Class Overview

An abstract overlay that supports displaying elements in a list of arbitrary objects. These objects can have annotations on methods to provide marker information (ProvidesMarkerGeoPoint, ProvidesMarkerTitle, etc.), or alternatively a "decorator" object can be specified that provides this information given an item on the map.

AbstractListOverlay provides no rendering of its own, only methods by which subclasses can access the decorations for the items that should be displayed on the map. Sofia comes with two concrete subclasses that should be suitable for most users:

• MarkerOverlay: displays each of the items in the list as a marker or "pin" on the map
• RouteOverlay: treats the items in the list as a sequence of waypoints or stops and draws a line that connects them

This class provides support for displaying an informational "balloon" containing the title and content of the item when it is tapped, but it is disabled by default for this class. The MarkerOverlay class enables it by default, and the RouteOverlay class leaves is disabled. Custom subclasses that want to enable this functionality should call setShowsBalloonWhenClicked(boolean).

Event Handling

Users can implement the following methods in the context that owns this overlay's MapView (for example, their MapScreen class) to receive event notifications:

[void|boolean] mapItemWasClicked(Item item)

Called when the user clicks the location on the map representing one of the items in the list. The type of the "item" parameter must be compatible with the type of objects in the overlay's list. If this method is boolean and returns true, the event is assumed to be "consumed" and the default balloon popup will not appear.

void mapBalloonWasClicked(Item item)

Called when the balloon popup attached to the specified item is clicked. The type of the "item" parameter must be compatible with the type of objects in the overlay's list.

Summary

[Expand] Inherited Constants
From class com.google.android.maps.Overlay float SHADOW_X_SKEW float SHADOW_Y_SCALE

[Expand] Inherited Methods
From class com.google.android.maps.Overlay void draw(Canvas arg0, MapView arg1, boolean arg2) boolean draw(Canvas arg0, MapView arg1, boolean arg2, long arg3) static void drawAt(Canvas arg0, Drawable arg1, int arg2, int arg3, boolean arg4) boolean onKeyDown(int arg0, KeyEvent arg1, MapView arg2) boolean onKeyUp(int arg0, KeyEvent arg1, MapView arg2) boolean onTap(GeoPoint arg0, MapView arg1) boolean onTouchEvent(MotionEvent arg0, MapView arg1) boolean onTrackballEvent(MotionEvent arg0, MapView arg1)
From class java.lang.Object Object clone() boolean equals(Object arg0) void finalize() final Class<?> getClass() int hashCode() final void notify() final void notifyAll() String toString() final void wait() final void wait(long arg0, int arg1) final void wait(long arg0)