com.supermap.web.mapping.FeaturesLayer

	属性	定义方
		bounds : Rectangle2D [Override] 获取或设置当前图层的地理范围，默认为该图层中所有 Feature 的 bounds （获取方法：Feature.geometry.bounds）的并集。	FeaturesLayer
		clusterer : Clusterer 获取或设置与 FeatureLayer 关联的 Clusterer 对象。	FeaturesLayer
		CRS : CoordinateReferenceSystem 获取或设置当前图层的坐标参考系（ CoordinateReferenceSystem ）。默认值为 null。设置 CoordinateReferenceSystem.wkid 属性后，图层将被动态投影至 wkid 所代表的投影坐标系下，若 wkid 小于等于 0 则不进行动态投影...	Layer
		features : Object 获取或设置当前图层的矢量要素集。	FeaturesLayer
		graduatedCount : int 获取或设置加载要素时，划分多少次来逐级显示要素，此属性只在通过 features 属性来加载要素时生效.	FeaturesLayer
		isFeatureMouseOver : Boolean 指定要素图层中的要素是否自动显示于图层最顶端.	FeaturesLayer
		isFront : Boolean 指定要素的加载顺序.	FeaturesLayer
		isInResolutionRange : Boolean [read-only] 判断与当前图层关联的 Map 的分辨率是否在当前图层的最大、最小分辨率范围内。true 表示在最大、最小范围内。	Layer
		isPanEnableOnFeature : Boolean 指定鼠标焦点在要素（Feature）上时是否可以进行地图平移操作。默认值为：false，表示鼠标焦点在要素（如面要素）上时不可进行地图平移操作，仅当鼠标焦点落在要素以外的地图范围内方可平移地图。	FeaturesLayer
		isRealtimeRefresh : Boolean 获取或设置当地图可视范围发生变化时否实时更新要素图层 FeatureLayer。	FeaturesLayer
		isScaleCentric : Boolean [read-only] 指示该图层是否有 DPI 值，ture 表示当前图层已根据从 SuperMap iServer 服务端获取的参数计算出 DPI；false 反之。WMS、WMTS 等图层该属性值为 false。DynamicRESTLayer、TiledDynamicRESTLayer 等专门关联 SuperMap iServer 服务的图层该属性为 true。	Layer
		isViewportClip : Boolean 是否对 FeatureLayer 上不在可视范围内的要素 Feature 进行裁剪，即对不在可视范围内的要素不进行绘制.	FeaturesLayer
		loaded : Boolean [read-only] 若当前图层已加载完闭则返回 true，否则返回 false。	Layer
		maxVisibleResolution : Number 当前图层的最大显示分辨率。即当图层缩放至该分辨率时就不能再放大。	Layer
		metadata : Object 获取或设置当前图层信息，包括图层标题、描述信息、图层所在地图控件名称。	Layer
		minVisibleResolution : Number 当前图层的最小显示分辨率。即当图层缩放至该分辨率时就不能再缩小。	Layer
		numFeatures : int [read-only] 获取当前图层包含的矢量要素个数。	FeaturesLayer
		renderer : Renderer 获取或设置 FeatureLayer 的渲染方式。	FeaturesLayer
		resolution : Number [read-only] 获取当前图层的显示分辨率。	Layer
		style : Style 获取或设置 FeatureLayer 的显示风格。.	FeaturesLayer
		url : String 图层所在的服务地址。	Layer
		viewBoundsExpandFactor : int 获取或设置当前地图显示范围的扩展倍数.	FeaturesLayer
		visible : Boolean [Override] 获取或设置当前图层是否可见。	Layer

	属性	定义方
		dpi : Number 获取当前图层的扫描精度，即单位面积内的像素的个数...	Layer

	方法	定义方
		FeaturesLayer() 初始化 FeatureLayer 类的新实例。	FeaturesLayer
		addFeature(feature:Feature, isfront:Boolean = true):String 在当前图层中添加矢量要素。当 isFront 属性为 true 时，新增的要素添加于 features 集合的最末端，反之添加到最前端。	FeaturesLayer
		addFeatureAt(feature:Feature, index:int):String 在指定位置处添加矢量要素。若传入的索引值超出范围（小于 0 或大于 features.length），将会抛出异常信息 SmResource.OUT_OF_ARRAY_RANGE。	FeaturesLayer
		clear():void 添除当前图层中的所有矢量要素。	FeaturesLayer
		getFeatureAt(index:int):Feature 获取指定位置处的矢量要素。如果 index 超出范围则抛出异常信息： SmResource.OUT_OF_ARRAY_RANGE。	FeaturesLayer
		getFeatureByID(id:String):Feature 通过要素 ID 获取要素。	FeaturesLayer
		getFeatureIndex(feature:Feature):int 获取矢量要素索引位置。如果指定的要素不在该图层中，则返回-1。	FeaturesLayer
		moveFeature(feature:Feature, index:int):void 将矢量要素移动至指定位置。如果 index 超出范围则抛出异常信息：SmResource.OUT_OF_ARRAY_RANGE。	FeaturesLayer
		moveFeatureAt(fromIndex:int, toIndex:int):void 将指定位置处的矢量要素移动至另一位置。如果索引值超出范围则抛出异常信息：SmResource.OUT_OF_ARRAY_RANGE。	FeaturesLayer
		moveToTop(feature:Feature):void 将指定矢量要素移动至顶端显示。	FeaturesLayer
		refresh():void 刷新图层，即调用 Layer.invalidateDisplayList() 方法(详情请参见 Flex SDK UIComponent.invalidateDisplayList() 方法)，更新 Layer 的显示列表。对于 GraphicsLayer 调用该方法会对 GraphicsLayer 上所有显示对象 Graphic 进行重绘。	Layer
		removeFeature(feature:Feature):Feature 移除指定的矢量要素。如果待移除的 Feature 不在图层中，则抛出异常信息：SmResource.OUT_OF_ARRAY_RANGE。	FeaturesLayer
		removeFeatureAt(index:int):Feature 移除指定位置处的矢量要素。如果索引值超出范围则抛出异常信息：SmResource.OUT_OF_ARRAY_RANGE。	FeaturesLayer

	方法	定义方
		addedHandler(event:Event):void 处理 Event.ADDED 事件的侦听器函数。	Layer
		addMapListeners():void [Override] 为当前图层添加事件侦听器，以使侦听器能够接收 ZoomEvent、 ViewBoundsEvent 事件的触发通知。	FeaturesLayer
		creationCompleteHandler(event:FlexEvent):void 当 FeatureLayer 创建完毕事件 FlexEvent.CREATION_COMPLETE 的侦听函数。的 features 属性发生变化是将触发 CollectionEvent.COLLECTION_CHANGE 事件，该方法用于侦听该事件。	FeaturesLayer
		draw():void [Override] 渲染出图，注意：子类必须重写该方法来实现渲染出图。	FeaturesLayer
		enterFrameHandler(event:Event):void Event.ENTER_FRAME 事件的侦听函数。	FeaturesLayer
		hideHandler(event:FlexEvent):void 处理 FlexEvent.HIDE 事件的侦听器函数。	Layer
		invalidateLayer():void 通过子类调用以更新图层。	Layer
		removeAllChildren():void [Override] 删除 Layer 上的所有对象。	FeaturesLayer
		removedHandler(event:Event):void 处理 Event.REMOVED 事件的侦听器函数。	Layer
		removeMapListeners():void [Override] 移除通过 addMapListeners 添加的事件侦听器。	FeaturesLayer
		setLoaded(value:Boolean):void 设置图层是否加载完闭，会触发 LayerEvent.LOAD 事件。true 表示当前图层已加载完毕。注意：任何继承 Layer 的子类都必须在 Layer 初始化完成之后调用该接口设置对应的图层是否加载完毕。	Layer
		showHandler(event:FlexEvent):void [Override] 处理 FlexEvent.SHOW 事件的侦听器函数。	FeaturesLayer
		viewBoundsChangedHandler(event:ViewBoundsEvent):void 处理 viewBoundsChanged 事件的侦听器函数。	Layer
		zoomEndHandler(event:ZoomEvent):void [Override] 处理 zoomEnd 事件的侦听器函数。	FeaturesLayer
		zoomStartHandler(event:ZoomEvent):void [Override] 处理 zoomStart 事件的侦听器函数。	FeaturesLayer
		zoomUpdateHandler(event:ZoomEvent):void 处理 zoomUpdate 事件的侦听器函数。	Layer

Summary	定义方
featureAdd	当在 FeatureLayer 中添加矢量要素时触发该事件。	FeaturesLayer
featureRemove	当在 FeatureLayer 中删除矢量要素时触发该事件。	FeaturesLayer
featureRemoveAll	当移除在 FeatureLayer 中所有矢量要素时触发该事件。	FeaturesLayer
isInResolutionRangeChange	当 Layer 的 IsInResolutionRange 属性发生变化时触发该事件。	Layer
load	当图层初始化完成时触发该事件。	Layer
loadError	当载入图层出错时触发该事件。	Layer
maxVisibleResolutionChange	当图层最大显示分辨率改变时触发该事件。	Layer
minVisibleResolutionChange	当图层最小显示分辨率改变时触发该事件。	Layer
styleChange	当 FeatureLayer 的显示风格 style 发生变化时触发该事件。	FeaturesLayer
updateEnd	当完成更新图层时触发该事件。	Layer
updateStart	当更新图层开始时触发该事件。	Layer
visibleChange	当图层的 visible 属性发生改变时触发该事件。	Layer

属性详细信息

bounds

属性

bounds:Rectangle2D[Override]

获取或设置当前图层的地理范围，默认为该图层中所有 Feature 的 bounds （获取方法：Feature.geometry.bounds）的并集。

Implementation
public function get bounds():Rectangle2D
public function set bounds(value:Rectangle2D):void

另请参见

com.supermap.web.core.geometry.Geometry.bounds

clusterer

属性

clusterer:Clusterer

获取或设置与 FeatureLayer 关联的 Clusterer 对象。

Implementation
public function get clusterer():Clusterer
public function set clusterer(value:Clusterer):void

另请参见

com.supermap.web.clustering.Clusterer

features

属性

features:Object

获取或设置当前图层的矢量要素集。

Implementation
public function get features():Object
public function set features(value:Object):void

graduatedCount

属性

graduatedCount:int

获取或设置加载要素时，划分多少次来逐级显示要素，此属性只在通过 features 属性来加载要素时生效.

对于使用 addFeature 或 addFeatureAt 等方法加载一个要素时不生效，默认值为 1 ，表示一次性全部加载显示。

默认值为： 1.

Implementation
public function get graduatedCount():int
public function set graduatedCount(value:int):void

isFeatureMouseOver

属性

isFeatureMouseOver:Boolean

指定要素图层中的要素是否自动显示于图层最顶端.

若该属性值为 true，则当鼠标悬停至 FeatureLayer 中任何一个要素 Feature 上时，该要素将自动显示于要素图层的最顶端。若属性值为 false，则屏蔽这种功能。默认值为 true。若想某一单个要素指定或屏蔽此功能，设置 Feature.autoMoveToTop 属性即可。

默认值为： true.

Implementation
public function get isFeatureMouseOver():Boolean
public function set isFeatureMouseOver(value:Boolean):void

另请参见

com.supermap.web.core.Feature.autoMoveToTop

isFront

属性

isFront:Boolean

指定要素的加载顺序.

当该属性值为 true 时，表示最先加载的要素显示于 FeatureLayer 的最底端，最后加载的要素显示于 FeatureLayer 的最顶端。当该属性值为 false 时，表示最先加载的要素显示于 FeatureLayer 的最顶端，最后加载的要素显示于 FeatureLayer 的最底端。默认值为 true。

默认值为： true.

Implementation
public function get isFront():Boolean
public function set isFront(value:Boolean):void

isPanEnableOnFeature

属性

isPanEnableOnFeature:Boolean

指定鼠标焦点在要素（Feature）上时是否可以进行地图平移操作。默认值为：false，表示鼠标焦点在要素（如面要素）上时不可进行地图平移操作，仅当鼠标焦点落在要素以外的地图范围内方可平移地图。

Implementation
public function get isPanEnableOnFeature():Boolean
public function set isPanEnableOnFeature(value:Boolean):void

isRealtimeRefresh

属性

isRealtimeRefresh:Boolean

获取或设置当地图可视范围发生变化时否实时更新要素图层 FeatureLayer。

Implementation
public function get isRealtimeRefresh():Boolean
public function set isRealtimeRefresh(value:Boolean):void

isViewportClip

属性

isViewportClip:Boolean

是否对 FeatureLayer 上不在可视范围内的要素 Feature 进行裁剪，即对不在可视范围内的要素不进行绘制.

当该属性值为 true 时，表示对不在可视范围内的要素 Feature 进行裁剪。当地图可视范围发生变化时，则实时绘制可视范围内被裁剪掉的要素 Feature。默认值为 true。

默认值为： true.

Implementation
public function get isViewportClip():Boolean
public function set isViewportClip(value:Boolean):void

numFeatures

属性

numFeatures:int [read-only]

获取当前图层包含的矢量要素个数。

Implementation
public function get numFeatures():int

renderer

属性

renderer:Renderer

获取或设置 FeatureLayer 的渲染方式。

Implementation
public function get renderer():Renderer
public function set renderer(value:Renderer):void

style

属性

style:Style

获取或设置 FeatureLayer 的显示风格。.

FeatureLayer.style、Feature.style、FeatureLayer.renderer 属性中的渲染样式这三者的优先级为：1——Feature.style，2——FeatureLayer.renderer 属性中的渲染样式，3——FeatureLayer.style。

Implementation
public function get style():Style
public function set style(value:Style):void

另请参见

renderer
style

viewBoundsExpandFactor

属性

viewBoundsExpandFactor:int

获取或设置当前地图显示范围的扩展倍数.

在图层刷新后，使用扩展后的显示范围对要素进行剪裁操作判断，在此扩展范围外的要素不做重绘。默认值为1。

默认值为： 1.

Implementation
public function get viewBoundsExpandFactor():int
public function set viewBoundsExpandFactor(value:int):void

构造函数详细信息

FeaturesLayer

()

构造函数

public function FeaturesLayer()

初始化 FeatureLayer 类的新实例。

方法详细描述

addFeature

()

方法

public function addFeature(feature:Feature, isfront:Boolean = true):String

在当前图层中添加矢量要素。当 isFront 属性为 true 时，新增的要素添加于 features 集合的最末端，反之添加到最前端。

参数

	`feature:Feature` — 要添加的矢量要素。

	`isfront:Boolean` (default = `true`)

String —

另请参见

isFront

addFeatureAt

()

方法

public function addFeatureAt(feature:Feature, index:int):String

在指定位置处添加矢量要素。若传入的索引值超出范围（小于 0 或大于 features.length），将会抛出异常信息 SmResource.OUT_OF_ARRAY_RANGE。

参数

	`feature:Feature` — 要添加的矢量要素。

	`index:int` — 指定的索引位置。

String — 返回矢量要素 ID。

另请参见

features
com.supermap.web.resources.SmResource

addMapListeners

()

方法

override protected function addMapListeners():void

为当前图层添加事件侦听器，以使侦听器能够接收 ZoomEvent、 ViewBoundsEvent 事件的触发通知。

clear

()

方法

public function clear():void

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

creationCompleteHandler

()

方法

protected function creationCompleteHandler(event:FlexEvent):void

当 FeatureLayer 创建完毕事件 FlexEvent.CREATION_COMPLETE 的侦听函数。的 features 属性发生变化是将触发 CollectionEvent.COLLECTION_CHANGE 事件，该方法用于侦听该事件。

参数

event:FlexEvent

draw

()

方法

override protected function draw():void

渲染出图，注意：子类必须重写该方法来实现渲染出图。

enterFrameHandler

()

方法

protected function enterFrameHandler(event:Event):void

Event.ENTER_FRAME 事件的侦听函数。

参数

event:Event

getFeatureAt

()

方法

public function getFeatureAt(index:int):Feature

获取指定位置处的矢量要素。如果 index 超出范围则抛出异常信息： SmResource.OUT_OF_ARRAY_RANGE。

参数

index:int — 指定的索引位置。

Feature — 返回获取到的矢量要素。

另请参见

com.supermap.web.resources.SmResource

getFeatureByID

()

方法

public function getFeatureByID(id:String):Feature

通过要素 ID 获取要素。

参数

id:String — 要素 ID。

Feature — 返回与 ID 对应的要素。

getFeatureIndex

()

方法

public function getFeatureIndex(feature:Feature):int

获取矢量要素索引位置。如果指定的要素不在该图层中，则返回-1。

参数

feature:Feature — 矢量要素。

int — 返回矢量要素索引位置。

moveFeature

()

方法

public function moveFeature(feature:Feature, index:int):void

将矢量要素移动至指定位置。如果 index 超出范围则抛出异常信息：SmResource.OUT_OF_ARRAY_RANGE。

参数

	`feature:Feature` — 要移动的矢量要素。

	`index:int` — 指定的索引位置。

另请参见

com.supermap.web.resources.SmResource

moveFeatureAt

()

方法

public function moveFeatureAt(fromIndex:int, toIndex:int):void

将指定位置处的矢量要素移动至另一位置。如果索引值超出范围则抛出异常信息：SmResource.OUT_OF_ARRAY_RANGE。

参数

	`fromIndex:int` — 被移动的矢量要素的索引位置。

	`toIndex:int` — 另一索引位置。

另请参见

com.supermap.web.resources.SmResource

moveToTop

()

方法

public function moveToTop(feature:Feature):void

将指定矢量要素移动至顶端显示。

参数

feature:Feature — 被移动的矢量要素。

removeAllChildren

()

方法

override protected function removeAllChildren():void

删除 Layer 上的所有对象。

removeFeature

()

方法

public function removeFeature(feature:Feature):Feature

移除指定的矢量要素。如果待移除的 Feature 不在图层中，则抛出异常信息：SmResource.OUT_OF_ARRAY_RANGE。

参数

feature:Feature — 被移除的矢量要素。

Feature — 返回被移除的矢量要素。

另请参见

com.supermap.web.resources.SmResource

removeFeatureAt

()

方法

public function removeFeatureAt(index:int):Feature

移除指定位置处的矢量要素。如果索引值超出范围则抛出异常信息：SmResource.OUT_OF_ARRAY_RANGE。

参数

index:int — 索引位置。

Feature — $[mapping_FeatureLayer_method_removeFeatureAt_return}

另请参见

com.supermap.web.resources.SmResource

removeMapListeners

()

方法

override protected function removeMapListeners():void

移除通过 addMapListeners 添加的事件侦听器。

showHandler

()

方法

override protected function showHandler(event:FlexEvent):void

处理 FlexEvent.SHOW 事件的侦听器函数。

参数

event:FlexEvent — 事件对象。

zoomEndHandler

()

方法

override protected function zoomEndHandler(event:ZoomEvent):void

处理 zoomEnd 事件的侦听器函数。

参数

event:ZoomEvent — ZoomEvent 事件类对象。

zoomStartHandler

()

方法

override protected function zoomStartHandler(event:ZoomEvent):void

处理 zoomStart 事件的侦听器函数。

参数

event:ZoomEvent

事件详细信息

featureAdd

事件

Event Object Type: com.supermap.web.events.FeatureLayerEvent

当在 FeatureLayer 中添加矢量要素时触发该事件。

featureRemove

事件

Event Object Type: com.supermap.web.events.FeatureLayerEvent

当在 FeatureLayer 中删除矢量要素时触发该事件。

featureRemoveAll

事件

Event Object Type: com.supermap.web.events.FeatureLayerEvent

当移除在 FeatureLayer 中所有矢量要素时触发该事件。

styleChange

事件

Event Object Type: flash.events.Event

当 FeatureLayer 的显示风格 style 发生变化时触发该事件。

另请参见

style

Wed Dec 23 2015, 12:01 AM +08:00

SuperMap iClient 8C for Flash 帮助文档	All Packages \| All Classes \| 索引模式 \|
FeaturesLayer	属性 \| 方法 \| 事件

包	com.supermap.web.mapping
类	public class FeaturesLayer
继承	FeaturesLayer Layer mx.core.UIComponent
子类	HeatGridLayer