目录

Polyline

Class Info

public final class Polyline

折线是一个点列表,其中线段在连续点之间绘制。在调用HuaweiMap类的addPolyline方法时会返回该类型的实例。

Public Method Summary

Qualifier and Type

Method Name and Description

void

remove()

从地图中删除此折线。

void

setClickable(boolean clickable)

设置折线的可点击性。

void

setColor(int color)

设置折线的颜色。

void

setColorValues(List<Integer> colors)

设置折线的多段颜色。

void

setEndCap(Cap endCap)

设置折线的末尾端点。

void

setGeodesic(boolean geodesic)

设置是否将折线的每个线段绘制为大地线。

void

setGradient(boolean on)

设置渐变属性。

void

setJointType(int jointType)

设置折线除起始和结束顶点之外的所有顶点的节点类型,有关允许的值,请参见JointType。

void

setPattern(List<PatternItem> pattern)

设置折线的样式。

void

setPoints(List<LatLng> points)

设置折线的顶点坐标。

void

setStartCap(Cap startCap)

设置折线的起始端点。

void

setTag(Object tag)

设置折线的tag属性。

void

setVisible(boolean visible)

设置折线的可见性。

void

setWidth(float width)

设置折线的宽度。

void

setZIndex(float zIndex)

设置折线的z指数。

Public Methods

[h2]remove

Method

public void remove()

从地图中删除此折线。删除折线后,其所有方法的行为都会消失。

[h2]setClickable

Method

public void setClickable(boolean clickable)

您调用此API可以设置折线的可点击性。

Parameters

Name

Description

clickable

可点击性。

  • true:可点击
  • false:不可点击

默认值为false。

[h2]setColor

Method

public void setColor(int color)

您调用此API可以设置折线的颜色。

Parameters

Name

Description

color

ARGB格式颜色值,默认值为黑色(0xff000000)。

[h2]setColorValues

Method

public void setColorValues(List<Integer> colors)

您调用此API可以设置折线的多段颜色。

Parameters

Name

Description

colors

多段颜色,ARGB格式颜色值。

[h2]setEndCap

Method

public void setEndCap(Cap endCap)

您调用此API可以设置折线的末尾端点。

Parameters

Name

Description

endCap

末尾端点,默认为ButtCap。

[h2]setGeodesic

Method

public void setGeodesic(boolean geodesic)

您调用此API可以设置是否将折线的每个线段绘制为大地线。如果未设置,则返回默认值false。

Parameters

Name

Description

geodesic

  • true:每段绘制为大地线。
  • false:不是大地线。

[h2]setGradient

Method

public void setGradient(boolean on)

您调用此API可以设置是否将折线的渐变属性。

Parameters

Name

Description

on

设置渐变属性,默认false。

  • true:渐变。
  • false:不渐变。

[h2]setJointType

Method

public void setJointType(int jointType)

设置折线除起始和结束顶点之外的所有顶点的节点类型,有关允许的值,请参见JointType。如果节点类型未定义或不是允许值之一,则将使用默认值DEFAULT。

Parameters

Name

Description

jointType

节点类型,默认值为DEFAULT。

[h2]setPattern

Method

public void setPattern(List<PatternItem> pattern)

您调用此API可以设置折线的样式。

Parameters

Name

Description

pattern

PatternItem对象的集合。默认的样式为实心,用null表示。

[h2]setPoints

Method

public void setPoints(List<LatLng> points)

您调用此API可以设置折线的顶点坐标,默认在折线终点到设置坐标点间生成一条直线。

Parameters

Name

Description

points

折线顶点的集合。默认情况下,折线不闭合;要形成闭合的折线,起点和终点必须相同。

[h2]setStartCap

Method

public void setStartCap(Cap startCap)

您调用此API可以设置折线的起始端点。

Parameters

Name

Description

startCap

起始端点,默认为ButtCap。

[h2]setTag

Method

public void setTag(Object tag)

您调用此API可以设置折线的tag属性,tag属性可以是任意对象,如果设置为空,则清除tag。当您不再需要使用tag时,您可以调用setTag(null)清除tag,以防止应用程序发生内存泄漏。

Parameters

Name

Description

tag

折线的tag属性。

[h2]setVisible

Method

public void setVisible(boolean visible)

设置折线的可见性。如果折线不可见,则不会绘制,其他所有状态均保留。

Parameters

Name

Description

visible

折线的可见性,默认值为true。

[h2]setWidth

Method

public void setWidth(float width)

您调用此API可以设置折线的宽度。

Parameters

Name

Description

width

折线的宽度,单位:像素。取值范围:大于等于0,默认为10像素。

说明:

为兼容性考虑,此接口推荐设置的折线实际宽度为设置值width的三倍。

Throws

Name

Description

IllegalArgumentException

当传入的宽度width是负数时。

[h2]setZIndex

Method

public void setZIndex(float zIndex)

用于设置折线的z指数。z指数指的是折线的叠加顺序,具有较大z指数的折线会绘制在具有较小z指数的折线上,具有相同z指数的叠加顺序为元素添加的先后顺序。

说明:

数量限制:添加Circle和Polygon的总数乘以2加上添加Polyline和GroundOverlay的总数不超过1450,否则会出现图形叠加错误。

Parameters

Name

Description

zIndex

z指数,即折线的叠加顺序。默认的z指数是0。