SuperMap.Layer.Graphic

该图层用于高速渲染带有点符号样式的矢量要素。

Inherits from

SuperMap.Layer

Summary

SuperMap.Layer.Graphic	该图层用于高速渲染带有点符号样式的矢量要素。
Properties
graphics	{Array(SuperMap.Graphic)}用于存放graphic要素。
isBaseLayer	{Boolean} 该图层是否是基础图层，默认值为 false。可以在构造函数中是通过options设置。
isFixed	{Boolean} 设置当前图层在鼠标拖动及放大缩小时位置是否固定，默认为 false。
Constructor
SuperMap.Layer.Graphic	创建一个矢量图层。
Functions
addGraphics	给这个图层添加Graphics。
destroy	销毁Grapchi图层，释放资源。
display	临时隐藏或者显示图层。通过对CSS控制产生即时效果，重新渲染失效。一般用 setVisibility 方法来动态控制图层的显示和隐藏。
drawGraphic	在当前图层中绘制一个graphic。如果参数中的样式（style）被设置则使用。否则使用矢量要素的样式。如果未设置要素的样式，则使用图层上的样式。
getGraphicById	通过给定一个id，返回对应的矢量要素。
getGraphicsByAttribute	通过给定一个属性的key值和value值，返回所有匹配的要素数组。
redraw	重绘该图层，成功则返回true，否则返回false。
refresh	让图层重新请求Graphics并重绘。 Triggers the refresh event if the layer is in range and visible.
removeAllGraphics	清除当前图层所有的矢量要素。
removeGraphics	从当前图层中删除Graphic。这个函数擦除所有传递进来的矢量要素。参数中的Graphics数组中的每一项，必须是已经添加到当前图层中的Graphic，如果无法确定Graphic数组，则可以调用removeAllGraphics来删除所有Graphic。如果要删除的Graphic数组中的元素特别多，推荐使用removeAllGraphics，删除所有Graphic后再重新添加。这样效率会更高。
setOpacity	设置图层的不透明度,取值[0-1]之间。使用方法如：

Properties

isBaseLayer

{Boolean} 该图层是否是基础图层，默认值为 false。可以在构造函数中是通过options设置。

isFixed

{Boolean} 设置当前图层在鼠标拖动及放大缩小时位置是否固定，默认为 false。

graphics

{Array(SuperMap.Graphic)}用于存放graphic要素。

Constructor

SuperMap.Layer.Graphic

创建一个矢量图层。

//创建一个名为“Graphic Layer”
 var graphicLayer = new SuperMap.Layer.Graphic("Graphic Layer", null, {
     hitdetection: true,
     useCanvasEvent: false
 });

Parameters

name	{String} 此图层的图层名。
options	{Object} 此类与父类提供的属性。
renderopation	{Object} 渲染属性； hitdetection是否开启事件，useCanvasEvent默认为false，需要首先设置hitdetection 是否是快速渲染模式，默认为开启状态

Returns

{SuperMap.Layer.Graphic} 新的矢量图层。

Functions

destroy

destroy: function()

销毁Grapchi图层，释放资源。

refresh

refresh: function( obj )

让图层重新请求Graphics并重绘。 Triggers the refresh event if the layer is in range and visible.

Parameters

obj	{Object} Optional object with properties for any listener of the refresh event.

redraw

redraw: function()

重绘该图层，成功则返回true，否则返回false。

Returns

{Boolean} 重绘该图层。

display

display: function( display )

临时隐藏或者显示图层。通过对CSS控制产生即时效果，重新渲染失效。一般用 setVisibility 方法来动态控制图层的显示和隐藏。

Parameters

display

{Boolean}true代表不隐藏，false代表隐藏。

graphicLayer.display(true/false);

setOpacity

setOpacity: function( opacity )

设置图层的不透明度,取值[0-1]之间。使用方法如：

var graphicLayer = new SuperMap.Layer.Graphic("Graphic Layer");
GraphicLayer.setOpacity(0.2);

Parameter

opacity

{Float} 图层的透明度，取值范围：[0-1]。

addGraphics

addGraphics: function( graphics )

给这个图层添加Graphics。

Parameters

Graphics

{Array(SuperMap.Graphic)}需要添加的要素数组。

removeGraphics

removeGraphics: function( graphics )

从当前图层中删除Graphic。这个函数擦除所有传递进来的矢量要素。参数中的Graphics数组中的每一项，必须是已经添加到当前图层中的Graphic，如果无法确定Graphic数组，则可以调用removeAllGraphics来删除所有Graphic。如果要删除的Graphic数组中的元素特别多，推荐使用removeAllGraphics，删除所有Graphic后再重新添加。这样效率会更高。

Parameters

Graphics

{Array(<SuperMap.Graphic.Vector>)} 要删除Graphic的数组。

removeAllGraphics

removeAllGraphics: function()

清除当前图层所有的矢量要素。

drawGraphic

drawGraphic: function( graphic,

option )

在当前图层中绘制一个graphic。如果参数中的样式（style）被设置则使用。否则使用矢量要素的样式。如果未设置要素的样式，则使用图层上的样式。

当要素的样式更改或者要素已经添加到图层上需要更新时使用该函数。

Parameters

graphic	{SuperMap.Graphic}需要绘制的要素
style	{String \| Object} 风格

getGraphicById

getGraphicById: function( graphicId )

通过给定一个id，返回对应的矢量要素。

Parameters

graphicId

{String}矢量要素的属性id。

Returns

{SuperMap.Graphic} 对应id的graphic，如果不存在则返回null。

getGraphicsByAttribute

getGraphicsByAttribute: function( attrName,

attrValue )

通过给定一个属性的key值和value值，返回所有匹配的要素数组。

Parameters

attrName	{String}属性的key。
attrValue	{Mixed}属性对应的value值。

Returns

Array(SuperMap.Graphic) 一个匹配的graphic数组。