com.mapbar.map

类 Overlay

java.lang.Object

com.mapbar.map.Mark

com.mapbar.map.Overlay

直接已知子类:

ArrowOverlay, CircleOverlay, IconOverlay, ModelOverlay, PointsOverlay, PolygonOverlay, PolylineOverlay, RouteOverlay, TrackOverlay

public abstract class Overlay
extends Mark

叠加层Overlay的基础类
默认属性：
Mark.setClickable(boolean): false setSelected(boolean): false Mark.setHidden(boolean): false Mark.setTag(int): 0 setColor(int): ARGB(0xff0000ff)

嵌套类概要

嵌套类

限定符和类型	类和说明
class	Overlay.Layer 图层布局
class	Overlay.StrokeStyle 线形设置

方法概要

限定符和类型	方法和说明
android.graphics.Rect	getBoundingBox() 获取当前Overlay的包络盒
NdsRect	getBoundingBoxNds() 获取当前Overlay的包络盒
int	getColor() 获取Overlay绘制时所使用的画刷颜色
int	getIndex() 获取图层索引值
int	getLayer() 获取当前Overlay图层布局类型
int	getZLevel() 获取当前Overlay的ZLevel
int	hitTest(android.graphics.Point clickPoint, android.graphics.Point grabbedPoint) 点击检测 最小的点击范围最小为高宽为40像素的区域
int	hitTestNds(android.graphics.Point clickPoint, NdsPoint grabbedPoint) 点击检测，坐标为Nds点 最小的点击范围最小为高宽为40像素的区域
void	relese() 销毁Overlay，一般用于手动销毁RouteOverlay，打断对离线数据的引用，防止离线数据不能及时安装和删除
void	setColor(int color) 设置Overlay绘制时使用的画刷颜色
void	setLayer(int layer) 设置图层布局类型
void	setSelected(boolean selected) 设置当前的Overlay是否为选中状态，会触发相应的MapRenderer.Listener.onOverlaySelected(Overlay, Point)和MapRenderer.Listener.onOverlayDeselected(Overlay)
void	setZLevel(int level) 设置当前Overlay的ZLevel，ZLevel值大的Overlay会显示在值小的上面，只用于控制同一层 setLayer(int)内的Overlay的压盖关系，和Annotation.setZLevel(int) 不相互影响。

从类继承的方法 com.mapbar.map.Mark

getCalloutStyle, getPosition, getPositionNds, getSubtitle, getTag, getTitle, isClickable, isHidden, isSelected, setCalloutStyle, setClickable, setHidden, setPosition, setPositionNds, setSubtitle, setTag, setTitle, showCallout

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

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

方法详细资料

setColor

public void setColor(int color)

设置Overlay绘制时使用的画刷颜色

参数:

color - 颜色值(ARGB)，一般为0xff0f0c0d的形式

getColor

public int getColor()

获取Overlay绘制时所使用的画刷颜色

返回:

画刷颜色(ARGB)

getLayer

public int getLayer()

获取当前Overlay图层布局类型

返回:

图层类型Overlay.Layer

另请参阅:

Overlay.Layer

setLayer

public void setLayer(int layer)

设置图层布局类型

参数:

layer - 图层类型Overlay.Layer

另请参阅:

Overlay.Layer

getIndex

public int getIndex()

获取图层索引值

返回:

索引值

hitTest

public int hitTest(android.graphics.Point clickPoint,
                   android.graphics.Point grabbedPoint)

点击检测
最小的点击范围最小为高宽为40像素的区域

参数:

clickPoint - 需要测试点击的点

grabbedPoint - 点击后引擎获取到的离点击点最近的有效点，一般来说和clickPoint是同一个点，此参数为输出

返回:

点击到的区域类型，如果返回的是Annotation.Area.icon，则表示的时点击到了Overlay本身，否则其他非Annotation.Area.none的值表示的是点击到了Overlay对应弹出的气泡

从以下版本开始:

4.9.x

另请参阅:

Annotation.Area

hitTestNds

public int hitTestNds(android.graphics.Point clickPoint,
                      NdsPoint grabbedPoint)

点击检测，坐标为Nds点
最小的点击范围最小为高宽为40像素的区域

参数:

clickPoint - 需要测试点击的点，Nds坐标

grabbedPoint - 点击后引擎获取到的离点击点最近的有效点，一般来说和clickPoint是同一个点，此参数为输出，Nds坐标

返回:

点击到的区域类型，如果返回的是Annotation.Area.icon，则表示的时点击到了Overlay本身，否则其他非Annotation.Area.none的值表示的是点击到了Overlay对应弹出的气泡

setSelected

public void setSelected(boolean selected)

设置当前的Overlay是否为选中状态，会触发相应的MapRenderer.Listener.onOverlaySelected(Overlay, Point)和MapRenderer.Listener.onOverlayDeselected(Overlay)

参数:

selected - true为选中状态，false为非选中状态

getBoundingBox

public android.graphics.Rect getBoundingBox()

获取当前Overlay的包络盒

返回:

获取包络盒

getBoundingBoxNds

public NdsRect getBoundingBoxNds()

获取当前Overlay的包络盒

返回:

Nds坐标下的包络盒 坐标类型为NDS坐标

setZLevel

public void setZLevel(int level)

设置当前Overlay的ZLevel，ZLevel值大的Overlay会显示在值小的上面，只用于控制同一层 setLayer(int)内的Overlay的压盖关系，和Annotation.setZLevel(int) 不相互影响。
MapRenderer.bringOverlayToTop(Overlay)和 MapRenderer.insertOverlayAtIndex(Overlay, int)会改变ZLevel值。

参数:

level - ZLevel级别

另请参阅:

getZLevel()

getZLevel

public int getZLevel()

获取当前Overlay的ZLevel

参数:

当前Overlay的ZLevel -

另请参阅:

setZLevel(int)

relese

public void relese()

销毁Overlay，一般用于手动销毁RouteOverlay，打断对离线数据的引用，防止离线数据不能及时安装和删除