com.mapbar.map

类 Annotation

java.lang.Object

com.mapbar.map.Mark

com.mapbar.map.Annotation

直接已知子类:

CustomAnnotation

public class Annotation
extends Mark

地图中的弹出气泡
默认属性：
Mark.setClickable(boolean): true
setSelected(boolean): false
Mark.setHidden(boolean): false
Mark.setTag(int): 0

Notice:

注意：无论当前地图中有多少Annotation能够以弹出方式显示的 Annotation只能有一个，一旦有一个Annotation被设置为弹出，那么之前弹出的 Annotation将自动消失。

嵌套类概要

嵌套类

限定符和类型	类和说明
class	Annotation.Area

构造器概要

构造器

构造器和说明
Annotation(int zLevel, NdsPoint pos, int iconId, Vector2DF vpos) 创建Annotation实例
Annotation(int zLevel, android.graphics.Point pos, int iconId, Vector2DF vpos) 创建Annotation实例

方法概要

限定符和类型	方法和说明
void	freeNativeMemeory() 手动释放引擎中Annotation的实例内存
java.lang.String	getIconText() 获取图标上的文字
int	getZLevel() 获取压盖等级
int	hitTest(android.graphics.Rect clickArea) 判断当前点击的区域
void	setIcon(int iconId, Vector2DF vpos) 设置显示图标
void	setIconText(java.lang.String text, int fillColor, int edgeColor, Vector2DF anchor) 设置图标上的文字
void	setIconTextSize(int size) 设置图标文字大小
void	setSelected(boolean selected) 设置当前Annotation是否为选中状态
void	setZLevel(int zLevel) 设置Z轴方向的等级，在相同位置的Annotation，Z值大的会压盖Z值较小的

从类继承的方法 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

构造器详细资料

Annotation

public Annotation(int zLevel,
                  android.graphics.Point pos,
                  int iconId,
                  Vector2DF vpos)

创建Annotation实例

参数:

zLevel - Z轴方向的等级，也就所处的压盖关系

pos - 所在位置，经纬度坐标

iconId - 所使用的图标ID。引擎默认的图标位于packet中，ID<1000，客户端自定义的图标应放在assets/navicore/res/ icons下面，且ID>=1000，可通过后缀"@m", "@h", "@xh"来适配不同设备。例如：1000.png，1000@m.png，1000@h.png，1000@xh.png。

vpos - 设置显示时调整的X轴，Y轴的偏移量
默认情况下显示时的位置为图标中心点
此参数可以设置显示时相对于图标中心点的偏移量

Annotation

public Annotation(int zLevel,
                  NdsPoint pos,
                  int iconId,
                  Vector2DF vpos)

创建Annotation实例

参数:

zLevel - Z轴方向的等级，也就所处的压盖关系

pos - 所在位置，Nds坐标

iconId - 所使用的图标ID

vpos - 设置显示时调整的X轴，Y轴的偏移量
默认情况下显示时的位置为图标中心点
此参数可以设置显示时相对于图标中心点的偏移量

方法详细资料

setIcon

public void setIcon(int iconId,
                    Vector2DF vpos)

设置显示图标

参数:

iconId - 显示时使用的图标ID

vpos - 显示时的相对图标中心的偏移量

setZLevel

public void setZLevel(int zLevel)

设置Z轴方向的等级，在相同位置的Annotation，Z值大的会压盖Z值较小的

参数:

zLevel - Z轴方向的等级

Notice:

选中setSelected(boolean)的 Annotation绘制时总会画在最上面

getZLevel

public int getZLevel()

获取压盖等级

返回:

Z轴方向的等级

setIconText

public void setIconText(java.lang.String text,
                        int fillColor,
                        int edgeColor,
                        Vector2DF anchor)

设置图标上的文字

参数:

text - 文字内容，最多9个字符

fillColor - 内容文字颜色

edgeColor - 描边颜色

anchor - 文字锚点位置，相对于图标左上角的偏移

getIconText

public java.lang.String getIconText()

获取图标上的文字

返回:

图标上的文字

setIconTextSize

public void setIconTextSize(int size)

设置图标文字大小

参数:

size - 文字大小
注意，这里文字大小是一个相对值，任何时候引擎中都只使用三种字号的字体，分别为大号，中号和小号，对应的值如下:
1. [16, ) : 大号
2. [14, 16) : 中号
3. (0, 14) : 小号
也就是说size有效范围为0-16之间，且只能表示三种字体大小

hitTest

public int hitTest(android.graphics.Rect clickArea)

判断当前点击的区域

参数:

clickArea - 点击区域

返回:

点击区域，类型为Annotation.Area

另请参阅:

Annotation.Area

setSelected

public void setSelected(boolean selected)

设置当前Annotation是否为选中状态

参数:

selected - true为选中状态，false为非选中状态，会触发相应的 MapRenderer.Listener.onAnnotationSelected(Annotation)和 MapRenderer.Listener.onAnnotationDeselected(Annotation) 回调

Notice:

选中的Annotation绘制时总会画在最上面，不管 setZLevel(int)设置的值是多少

freeNativeMemeory

public void freeNativeMemeory()

手动释放引擎中Annotation的实例内存

Notice:

注意：只有你使用的Annotation 没有添加到MapRenderer中时，需要手动释放
其他情况禁止使用此方法。