com.supermap.android.maps

类 ItemizedOverlay<Item extends OverlayItem>

java.lang.Object

com.supermap.android.maps.Overlay

com.supermap.android.maps.ItemizedOverlay<Item>

直接已知子类:

DefaultItemizedOverlay

public abstract class ItemizedOverlay<Item extends OverlayItem>
extends Overlay

ItemizedOverlay是Overlay的一个基类，ItemizedOverlay包含了一个OverlayItem列表。

用于绘制、创建平移边界、为每个点绘制标记点，和维护一个焦点点中的item，同时负责把屏幕点击匹配到item上去，分发焦点改变事件给备选的监听器。 添加覆盖物的一般流程：
1.用OverlayItem准备Overlay数据信息；
2.继承ItemizedOverlay重写createItem()和size()方法；
3.调用Mapview.getOverlays().add()添加overlay到mapview中；
4.调用Mapview.refresh()使overlay生效。

嵌套类概要

嵌套类

限定符和类型	类和说明
static interface	ItemizedOverlay.OnClickListener 点击Overlay监听事件。
static interface	ItemizedOverlay.OnFocusChangeListener 焦点在Overlay发生变化监听事件。

从类继承的嵌套类/接口 com.supermap.android.maps.Overlay

Overlay.OverlayTapListener, Overlay.OverlayTouchEventListener, Overlay.OverlayTrackballEventListener

字段概要

从类继承的字段 com.supermap.android.maps.Overlay

tapListener, touchListener, trackballListener

构造器概要

构造器

构造器和说明
ItemizedOverlay(Drawable marker) 构造函数。
ItemizedOverlay(Drawable marker, int alignment) 构造函数。

方法概要

方法

限定符和类型	方法和说明
void	clear() 清除所有覆盖物。
protected abstract Item	createItem(int paramInt) 子类通过该方法创建实体item。
void	destroy() 销毁覆盖物。
void	draw(Canvas canvas, MapView mapView, boolean shadow) 绘制覆盖物。
BoundingBox	getBoundingBox() 获取边界框。
Point2D	getCenter() 获取中心点。
OverlayItem	getFocus() 获取关注的焦点。
OverlayItem	getItem(int position) 根据索引获取要绘制的item。
int	getLastFocusedIndex() 获取上一个关注的焦点。
boolean	onKeyUp(int keyCode, KeyEvent event, MapView mapView) 判断是否有相应按键抬起的操作。
boolean	onSnapToItem(int x, int y, Point snapPoint, MapView mapView) 判断是否捕捉到了item。
boolean	onTap(Point2D p, MapView mapView) 判断是否具有点击操作。
boolean	onTouchEvent(MotionEvent evt, MapView mapView) 判断是否存在触屏操作。
boolean	onTrackballEvent(MotionEvent evt, MapView mapView) 判断是否存在跟踪球事件发生。
void	setDrawFocusedItem(boolean drawFocusedItem) 设置绘制的焦点item对象。
void	setFocus(Item item) 设置绘图焦点。
protected void	setLastFocusedIndex(int lastFocusedIndex) 设置最近（或当前）焦点选中的item的索引，如果没有item被选中则设置为-1。
void	setOnClickListener(ItemizedOverlay.OnClickListener l) 设置点击Overlay监听器。
void	setOnFocusChangeListener(ItemizedOverlay.OnFocusChangeListener l) 设置焦点变化监听器。
abstract int	size() 返回overlay的item的数目。

从类继承的方法 com.supermap.android.maps.Overlay

draw, drawAt, getKey, getZIndex, onKeyDown, setKey, setTapListener, setTouchEventListener, setTrackballEventListener, setZIndex

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

构造器详细资料

ItemizedOverlay

public ItemizedOverlay(Drawable marker)

构造函数。

参数:

marker - 覆盖物标记。

ItemizedOverlay

public ItemizedOverlay(Drawable marker,
               int alignment)

构造函数。

参数:

marker - 覆盖物标记。

alignment -

方法详细资料

draw

public void draw(Canvas canvas,
        MapView mapView,
        boolean shadow)

绘制覆盖物。

覆盖:

draw 在类中 Overlay

参数:

canvas - 画布。

mapView - 指定绘制的地图视图。

shadow - 是否带有阴影。

createItem

protected abstract Item createItem(int paramInt)

子类通过该方法创建实体item。

参数:

paramInt -

返回:

size

public abstract int size()

返回overlay的item的数目。

返回:

getItem

public final OverlayItem getItem(int position)

根据索引获取要绘制的item。

参数:

position - 索引位置。

返回:

要绘制的item。

clear

public void clear()

清除所有覆盖物。

getCenter

public Point2D getCenter()

获取中心点。

返回:

中心点。

getBoundingBox

public BoundingBox getBoundingBox()

获取边界框。

返回:

边界框。

destroy

public void destroy()

销毁覆盖物。

覆盖:

destroy 在类中 Overlay

setDrawFocusedItem

public void setDrawFocusedItem(boolean drawFocusedItem)

设置绘制的焦点item对象。

参数:

drawFocusedItem - 绘制的焦点item对象。

getLastFocusedIndex

public final int getLastFocusedIndex()

获取上一个关注的焦点。

返回:

上一个关注的焦点的索引。

getFocus

public OverlayItem getFocus()

获取关注的焦点。

返回:

选中的覆盖物构件。

onKeyUp

public boolean onKeyUp(int keyCode,
              KeyEvent event,
              MapView mapView)

判断是否有相应按键抬起的操作。

覆盖:

onKeyUp 在类中 Overlay

参数:

keyCode - 按键编码。

event - 操作事件。

mapView - 操作所在的地图视图。

返回:

True表示按键抬起，False表示没有。

onSnapToItem

public boolean onSnapToItem(int x,
                   int y,
                   Point snapPoint,
                   MapView mapView)

判断是否捕捉到了item。

参数:

x -

y -

snapPoint - 捕捉点的屏幕像素坐标。

mapView - 捕捉点所在地图视图。

返回:

True表示捕捉到了，反之没有。

setFocus

public void setFocus(Item item)

设置绘图焦点。

参数:

item -

setLastFocusedIndex

protected void setLastFocusedIndex(int lastFocusedIndex)

设置最近（或当前）焦点选中的item的索引，如果没有item被选中则设置为-1。

参数:

lastFocusedIndex - 给定的最近（或当前）焦点选中的item的索引。

onTap

public boolean onTap(Point2D p,
            MapView mapView)

判断是否具有点击操作。

覆盖:

onTap 在类中 Overlay

参数:

p - 点击的位置坐标。

mapView - 操作所在的地图视图。

返回:

True表示有点击，False表示没有。

onTouchEvent

public boolean onTouchEvent(MotionEvent evt,
                   MapView mapView)

判断是否存在触屏操作。

覆盖:

onTouchEvent 在类中 Overlay

参数:

evt - 触屏操作对象。

mapView - 操作所在的地图视图。

返回:

True表示有触屏操作，False表示没有。

onTrackballEvent

public boolean onTrackballEvent(MotionEvent evt,
                       MapView mapView)

判断是否存在跟踪球事件发生。

覆盖:

onTrackballEvent 在类中 Overlay

参数:

evt - 触屏操作对象。

mapView - 操作所在的地图视图。

返回:

True表示有触屏操作，False表示没有。

setOnFocusChangeListener

public void setOnFocusChangeListener(ItemizedOverlay.OnFocusChangeListener l)

设置焦点变化监听器。

参数:

l - 焦点变化监听器。

setOnClickListener

public void setOnClickListener(ItemizedOverlay.OnClickListener l)

设置点击Overlay监听器。

参数:

l - 点击Overlay监听器。