com.supermap.mapping
类 Layers

java.lang.Object
  继承者 com.supermap.mapping.Layers

public class Layers
extends java.lang.Object

图层集合类。该类对一个地图对象中的所有图层进行管理。

一个图层集合对象中可包含各种类型的普通图层和专题图层,并且分别提供普通图层和专题图层的创建方法,注意:专题图层的专题图对象和图层所对应的数据集一样在创建时指定,之后不可更改为其他类型的专题图对象,而只可以对指定专题图对象进行修改和设置。

该类中提供了图层的添加、删除、查找以及移动等的方法,并且可以设置图层为可编辑或不可编辑。同时,图层集合对象允许其中的多个图层同时处于可编辑状态,这样你可以同时对多个图层进行编辑,从而提高工作效率。

示例:
以下代码示范了使用图层集合类对图层进行清除、添加、插入、移动、删除等操作。
 public void layersTest() {
        // 返回 captial、world、ocean 数据集
        Workspace workspace = new Workspace();
        WorkspaceConnectionInfo workspaceConnectionInfo = new WorkspaceConnectionInfo();
        workspaceConnectionInfo.setServer("C:/Documents and Settings/Administrator/桌面/World/world.sxwu");
        workspaceConnectionInfo.setType(WorkspaceType.SXWU);
        workspace.open(workspaceConnectionInfo);
        Datasource datasource = workspace.getDatasources().get(0);
        Dataset dataset0 = datasource.getDatasets().get("capital");
        Dataset dataset1 = datasource.getDatasets().get("world");
        Dataset dataset2 = datasource.getDatasets().get("ocean");

        // 打开地图
        Map map = new Map(workspace);
        map.open(workspace.getMaps().get(0));
        map.refresh();

        // 返回图层集合
        Layers layers = map.getLayers();

        // 构造 LayerSettingVector 对象并进行设置
        LayerSettingVector layerSettingVector = new LayerSettingVector();
        GeoStyle style = new GeoStyle();
        style.setFillForeColor(java.awt.Color.lightGray);
        layerSettingVector.setStyle(style);


        // 对图层集合进行操作,包括删除、添加、插入、移动、清除等
        layers.clear();
        layers.add(dataset1, new LayerSettingVector(), true);
        layers.add(dataset0, new LayerSettingVector(), true);
        System.out.println(layers.getCount());
        layers.insert(2, dataset2, new LayerSettingVector());
        System.out.println(layers.getCount());
        layers.moveDown(2);
        layers.remove(2);
        System.out.println(layers.getCount());

        // 释放资源
        map.close();
        map.dispose();
        datasource.close();
        workspaceConnectionInfo.dispose();
        workspace.dispose();
    }
 

方法摘要
 Layer add(Dataset dataset, boolean addToHead)
          用于把一个数据集添加到此图层集合作为一个普通图层显示,即创建一个普通图层。
 Layer add(Dataset dataset, LayerSetting layerSetting, boolean addToHead)
          用于把一个数据集添加到此图层集合作为一个普通图层显示,即创建一个普通图层。
 Layer add(Dataset dataset, Theme theme, boolean addToHead)
          用于将一个数据集添加到此图层集合作为一个专题图层显示,即创建一个专题图层,并指定专题图层的专题图对象。
 boolean add(Layer layer)
          向图层集合中添加一个图层。
 LayerCache AddCache(java.lang.String sciFile, boolean addToHead)
          根据缓存配置文件创建一个多版本缓存图层( LayerCache对象)。
 LayerCache AddCache(java.lang.String server, java.lang.String database, java.lang.String name, boolean addToHead)
           
 LayerCache AddCache(java.lang.String server, java.lang.String database, java.lang.String name, boolean addToHead, java.lang.String user, java.lang.String pwd)
           
 Layer addChart(DatasetGroup datasetGroup, boolean addToHead)
          用于将一个数据集分组添加到地图的图层集中,以增加一个海图图层。
 LayerGridAggregation AddGridAggregation(Dataset dataset)
          根据给定的点数据集制作一幅默认风格的网格聚合图。
 LayerGridAggregation AddGridAggregation(Dataset dataset, java.awt.Color maxColor, java.awt.Color minColor)
          根据给定的点数据集和参数设置制作一幅网格聚合图,也就是将给定的点数据以网格聚合图的渲染方式进行显示。
 LayerGridAggregation AddGridAggregation(MemRecordset recordset)
          根据给定的内存点记录集制作一幅默认风格的网格聚合图。
 LayerGridAggregation AddGridAggregation(MemRecordset recordset, java.awt.Color maxColor, java.awt.Color minColor)
          根据给定的内存点记录集和参数设置制作一幅网格聚合图,也就是将给定的点数据以网格聚合图的渲染方式进行显示。
 LayerGroup addGroup(java.lang.String groupName)
          向图层集合中添加一个分组图层。
 LayerHeatmap AddHeatmap(Dataset dataset, int kernelRadius)
          根据给定的点数据集和参数设置制作一幅热力图,也就是将给定的点数据以热力图的渲染方式进行显示。
 LayerHeatmap AddHeatmap(Dataset dataset, int kernelRadius, java.awt.Color maxColor, java.awt.Color minColor)
          根据给定的点数据集和参数设置制作一幅热力图,也就是将给定的点数据以热力图的渲染方式进行显示。
 LayerHeatmap AddHeatmap(MemRecordset recordset, int kernelRadius)
          根据给定的内存点记录集和参数设置制作一幅热力图,也就是将给定的点数据以热力图的渲染方式进行显示。
 LayerHeatmap AddHeatmap(MemRecordset recordset, int kernelRadius, java.awt.Color maxColor, java.awt.Color minColor)
          根据给定的内存点记录集和参数设置制作一幅热力图,也就是将给定的点数据以热力图的渲染方式进行显示。
 void addLayerAddedListener(LayerAddedListener l)
          添加一个用于接收图层被添加事件(LayerAddedEvent)的监听器。
 void addLayerCaptionChangedListener(LayerCaptionChangedListener l)
          添加一个用于接收图层标题变化事件(LayerCaptionChangedEvent)的监听器。
 void addLayerDrawingListener(LayerDrawingListener l)
          添加一个用于接收绘制图层事件(LayerDrawingEvent)的监听器。
 void addLayerDrawnListener(LayerDrawnListener l)
          添加一个用于接收绘制图层结束事件(LayerDrawnEvent)的监听器。
 void addLayerEditableChangedListener(LayerEditableChangedListener l)
          添加一个用于接收图层可编辑状态变化事件(LayerEditableChangedEvent)的监听器。
 void addLayerGroupAddedListener(LayerGroupAddedListener l)
          添加一个用于接收向图层集合中添加分组图层结束事件(LayerGroupAddedEvent)的监听器。
 void addLayerGroupRemovedListener(LayerGroupRemovedListener l)
          添加一个用于接收从图层集合移除分组图层结束事件(LayerGroupRemovedEvent)的监听器。
 void addLayerRemovedListener(LayerRemovedListener l)
          添加一个用于接收图层被删除事件(LayerRemovedEvent)的监听器。
 void addLayerSelectableChangedListener(LayerSelectableChangedListener l)
          添加一个用于接收图层可选择状态变化事件(LayerSelectableChangedEvent)的监听器。
 void addLayerSnapableChangedListener(LayerSnapableChangedListener l)
          添加一个用于接收图层可捕捉状态改变事件(LayerSnapableChangedEvent)的监听器。
 void addLayerSnapshotAddedListener(LayerSnapshotAddedListener l)
          添加一个用于接收添加快照图层事件(LayerSnapshotAddedEvent)的监听器。
 void addLayerSnapshotRemovedListener(LayerSnapshotRemovedListener l)
          添加一个用于接收移除快照图层事件(LayerSnapshotRemovedEvent)的监听器。
 void addLayerVisibleChangedListener(LayerVisibleChangedListener l)
          添加一个用于接收图层可视状态改变事件(LayerVisibleChangedEvent)的监听器。
 LayerMosaicGroup addMosaicGroup(DatasetMosaic datasetMosaic, java.lang.Boolean addToHead)
          将一个镶嵌数据集添加到图层集合中作为一个镶嵌数据集图层分组进行显示。
 void clear()
          删除此图层集合对象中所有的图层。
 boolean contains(java.lang.String name)
          判定此图层集合对象是否包含指定名称的图层。
 Layer findLayer(java.lang.String layerName)
          返回指定的图层名称的图层对象。
 Layer get(int index)
          返回此图层集合中指定索引的图层对象。
 Layer get(java.lang.String name)
          返回此图层集合中指定名称的图层对象。
 java.lang.String getAvailableCaption(java.lang.String layerCaption)
          返回一个可用的图层显示名称。
 int getCount()
          返回此图层集合中图层对象的总数。
 int indexOf(java.lang.String name)
          返回此图层集合中指定名称的图层的索引。
 Layer insert(int index, Dataset dataset)
          用于把一个数据集插入到此图层集合中作为一个普通图层显示。
 Layer insert(int index, Dataset dataset, LayerSetting layerSetting)
          用于插入一个数据集到此图层集合中作为一个普通图层显示。
 Layer insert(int index, Dataset dataset, Theme theme)
          用于插入一个数据集到此图层集合中,作为一个专题图层显示,并指定专题图层的专题图对象。
 boolean insert(int index, Layer layer)
          向图层集合中的指定索引位置插入一个图层。
 LayerGroup insertGroup(int index, java.lang.String groupName)
          向图层集合中插入一个分组图层。
 Layer insertLayer(int index, java.lang.String layerXml)
          在指定索引位置插入图层对象。
 LayerSnapshot insertLayerSnapshot(int index, java.lang.String snapshotName)
          从图层集合中插入一个快照图层。
 LayerMosaicGroup insertMosaicGroup(int index, DatasetMosaic datasetMosaic)
          将一个镶嵌数据集插入到图层集合中作为一个镶嵌数据集图层分组进行显示。
 boolean moveDown(int index)
          将此图层集合中指定索引的图层往下移动一层。
 boolean moveTo(int srcIndex, int desIndex)
          将此图层集合中的指定索引的图层移动到指定的目标索引。
 boolean moveToBottom(int index)
          将此图层集合中指定索引的图层移动到最底层。
 boolean moveToTop(int index)
          将此图层集合中指定索引的图层移动到最顶层。
 boolean moveUp(int index)
          将此图层集合中指定索引的图层往上移动一层。
 boolean remove(int index)
          从此图层集合中删除一个指定索引的图层。
 boolean remove(Layer layer)
          从图层集合中移除一个指定的图层。
 boolean remove(java.lang.String name)
          从此图层集合中删除一个指定名称的图层。
 int removeByDataset(Dataset dataset)
          按照指定数据集删除相关图层。
 boolean removeGroup(LayerGroup group)
          从图层集合中移除指定的分组图层。
 void removeLayerAddedListener(LayerAddedListener l)
          移除一个用于接收图层被添加事件(LayerAddedEvent)的监听器。
 void removeLayerCaptionChangedListener(LayerCaptionChangedListener l)
          移除一个用于接收图层标题变化事件(LayerCaptionChangedEvent)的监听器。
 void removeLayerDrawingListener(LayerDrawingListener l)
          移除一个用于接收绘制图层事件(LayerDrawingEvent)的监听器。
 void removeLayerDrawnListener(LayerDrawnListener l)
          移除一个用于接收绘制图层结束事件(LayerDrawnEvent)的监听器。
 void removeLayerEditableChangedListener(LayerEditableChangedListener l)
          移除一个用于接收图层可编辑状态变化事件(LayerEditableChangedEvent)的监听器。
 void removeLayerGroupAddedListener(LayerGroupAddedListener l)
          移除一个用于接收向图层集合中添加分组图层结束事件(LayerGroupAddedEvent)的监听器。
 void removeLayerGroupRemovedListener(LayerGroupRemovedListener l)
          移除一个用于接收从图层集合移除分组图层结束事件(LayerGroupRemovedEvent)的监听器。
 void removeLayerRemovedListener(LayerRemovedListener l)
          移除一个用于接收图层被删除事件(LayerRemovedEvent)的监听器。
 void removeLayerSelectableChangedListener(LayerSelectableChangedListener l)
          移除一个用于接收图层可选择状态变化事件(LayerSelectableChangedEvent)的监听器。
 void removeLayerSnapableChangedListener(LayerSnapableChangedListener l)
          移除一个用于接收图层可捕捉状态改变事件(LayerSnapableChangedEvent)的监听器。
 void removeLayerSnapshotAddedListener(LayerSnapshotAddedListener l)
          移除一个用于接收添加快照图层事件(LayerSnapshotAddedEvent)的监听器。
 void removeLayerSnapshotRemovedListener(LayerSnapshotRemovedListener l)
          移除一个用于接收移除快照图层事件(LayerSnapshotRemovedEvent)的监听器。
 void removeLayerVisibleChangedListener(LayerVisibleChangedListener l)
          移除一个用于接收图层可视状态改变事件(LayerVisibleChangedEvent)的监听器。
 int removeRange(int startIndex, int count)
          在此图层集合中从指定索引开始删除指定个数的图层。
 
从类 java.lang.Object 继承的方法
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

方法详细信息

getCount

public int getCount()
返回此图层集合中图层对象的总数。

返回:
此图层集合中图层对象的总数。
默认值:
默认值为 0,即图层集合中没有图层对象。

get

public Layer get(java.lang.String name)
返回此图层集合中指定名称的图层对象。

参数:
name - 要返回的图层的名称。
返回:
此图层集合中指定名称的图层对象。
示例:
请参见 Layer 的示例。

get

public Layer get(int index)
返回此图层集合中指定索引的图层对象。图层集合中图层的索引从 0 开始,从顶层开始依次编号。

参数:
index - 要返回的图层的索引。
返回:
此图层集合中指定索引的图层对象。

add

public Layer add(Dataset dataset,
                 boolean addToHead)
用于把一个数据集添加到此图层集合作为一个普通图层显示,即创建一个普通图层。其风格由系统默认设置。

参数:
dataset - 要显示的数据集。
addToHead - 指定新添加的图层是否放在图层集合的最上面一层。当设置为 false 时,则将此新添加图层放在最底层。
返回:
新添加的图层。
示例:
以下代码示范了如何将数据集添加到图层中
 public void addTest() {
        // 打开数据源
        Workspace workspace = new Workspace();
        MapControl mapControl = new MapControl();
        mapControl.getMap().setWorkspace(workspace);
        String path = "G:/World/World.udb";
        DatasourceConnectionInfo datasourceConnectionInfo = new
                DatasourceConnectionInfo(path, "World", "");
        workspace.getDatasources().open(datasourceConnectionInfo);

        // 返回数据集
        Dataset dataset = workspace.getDatasources().get(0).getDatasets().get(
                "World");

        // 将数据集添加到此图层集合作为一个普通图层显示
        Layer layer = mapControl.getMap().getLayers().add(dataset, true);

        // 释放资源
        mapControl.dispose();
        workspace.dispose();
    }
 

add

public Layer add(Dataset dataset,
                 LayerSetting layerSetting,
                 boolean addToHead)
用于把一个数据集添加到此图层集合作为一个普通图层显示,即创建一个普通图层。 该方法允许用户指定图层设置对象,即对矢量图层用户可以指定要素的显示风格;对栅格图层用户可以指定颜色表;对影像图层,用户可以指定透明度。

参数:
dataset - 要显示的数据集。
layerSetting - 普通图层的图层设置对象。
addToHead - 指定新创建图层是否放在图层集合的最上面一层。当设置为 false 时,则将此新创建图层放在最底层。
返回:
新添加的图层。
示例:
请参见 Layers 类的示例。

add

public Layer add(Dataset dataset,
                 Theme theme,
                 boolean addToHead)
用于将一个数据集添加到此图层集合作为一个专题图层显示,即创建一个专题图层,并指定专题图层的专题图对象。注意专题图层的专题图对象一旦指定,则不可更改为其他类型的专题图对象。例如创建时指定该图层的专题图对象为范围专题图对象,则之后不可以将其改为标签专题图或统计专题图等其他专题图对象。

参数:
dataset - 要显示的数据集。
theme - 指定此专题图层的专题图对象。
addToHead - 指定新创建图层是否放在图层集合的最上面一层。当设置为 false 时,则将此新创建图层放在最底层。
返回:
新添加的专题图层。
另请参见:
Layer.setThemeElementPosition(int, com.supermap.data.Point2D)
示例:
请参见 Layer.setThemeElementPosition() 方法的示例。

insert

public Layer insert(int index,
                    Dataset dataset)
用于把一个数据集插入到此图层集合中作为一个普通图层显示。

参数:
index - 插入的数据集在图层中的索引。
dataset - 待插入的数据集。
返回:
新插入的图层。

insert

public Layer insert(int index,
                    Dataset dataset,
                    LayerSetting layerSetting)
用于插入一个数据集到此图层集合中作为一个普通图层显示。

参数:
index - 插入的数据集在图层中的索引。
dataset - 待插入的数据集。
layerSetting - 普通图层的图层设置对象。
返回:
新插入的图层。
示例:
请参见 Layers 类的示例。

insert

public Layer insert(int index,
                    Dataset dataset,
                    Theme theme)
用于插入一个数据集到此图层集合中,作为一个专题图层显示,并指定专题图层的专题图对象。

注意专题图层的专题图对象一旦指定,则不可更改为其他类型的专题图对象。 例如创建时指定该图层的专题图对象为范围专题图对象,则之后不可以将其改为标签专题图或统计专题图等其他专题图对象。

参数:
index - 插入的数据集在图层中的索引。
dataset - 待插入的数据集。
theme - 指定此专题图层的专题图对象。
返回:
新插入的图层。

removeRange

public int removeRange(int startIndex,
                       int count)
在此图层集合中从指定索引开始删除指定个数的图层。返回删除的图层个数。

参数:
startIndex - 要删除的图层的起始索引。
count - 要删除的图层个数。
返回:
删除的图层数。

remove

public boolean remove(int index)
从此图层集合中删除一个指定索引的图层。删除成功则返回 true。

参数:
index - 要删除的图层的索引。
返回:
删除成功则返回 true,否则返回 false。
示例:
请参见 Layers 类的示例。

remove

public boolean remove(java.lang.String name)
从此图层集合中删除一个指定名称的图层。删除成功则返回 true。

参数:
name - 要删除图层的名称。
返回:
删除成功则返回 true,否则返回 false。

clear

public void clear()
删除此图层集合对象中所有的图层。

示例:
请参见 Layers 类的示例。

removeByDataset

public int removeByDataset(Dataset dataset)
按照指定数据集删除相关图层。

参数:
dataset - 指定的数据集。
返回:
按照指定数据集删除的相关图层的个数。

indexOf

public int indexOf(java.lang.String name)
返回此图层集合中指定名称的图层的索引。

参数:
name - 要查找的图层的名称。
返回:
找到指定图层则返回图层索引,否则返回-1。

contains

public boolean contains(java.lang.String name)
判定此图层集合对象是否包含指定名称的图层。

参数:
name - 可能包含在此图层集合中的图层对象的名称。
返回:
若此图层中包含指定名称的图层则返回 true,否则返回 false。

moveToTop

public boolean moveToTop(int index)
将此图层集合中指定索引的图层移动到最顶层。

参数:
index - 要移动到最顶层的图层的索引。
返回:
移动成功返回 true,否则返回 false。

moveToBottom

public boolean moveToBottom(int index)
将此图层集合中指定索引的图层移动到最底层。

参数:
index - 要移动到最底层的图层的索引。
返回:
移动成功返回 true,否则返回 false。

moveUp

public boolean moveUp(int index)
将此图层集合中指定索引的图层往上移动一层。

参数:
index - 要移动的图层的索引。
返回:
移动成功返回 true,否则返回 false。

moveDown

public boolean moveDown(int index)
将此图层集合中指定索引的图层往下移动一层。

参数:
index - 要移动的图层的索引。
返回:
移动成功返回 true,否则返回 false。
示例:
请参见 Layers 类的示例。

moveTo

public boolean moveTo(int srcIndex,
                      int desIndex)
将此图层集合中的指定索引的图层移动到指定的目标索引。

参数:
srcIndex - 要移动图层的原索引。
desIndex - 图层要移动到的目标索引。
返回:
移动成功返回 true,否则返回 false。

addLayerDrawingListener

public void addLayerDrawingListener(LayerDrawingListener l)
添加一个用于接收绘制图层事件(LayerDrawingEvent)的监听器。

参数:
l - 一个用于接收绘制图层事件的监听器。

removeLayerDrawingListener

public void removeLayerDrawingListener(LayerDrawingListener l)
移除一个用于接收绘制图层事件(LayerDrawingEvent)的监听器。

参数:
l - 一个用于接收绘制图层事件的监听器。

addLayerDrawnListener

public void addLayerDrawnListener(LayerDrawnListener l)
添加一个用于接收绘制图层结束事件(LayerDrawnEvent)的监听器。

参数:
l - 一个用于接收绘制图层结束事件的监听器。

removeLayerDrawnListener

public void removeLayerDrawnListener(LayerDrawnListener l)
移除一个用于接收绘制图层结束事件(LayerDrawnEvent)的监听器。

参数:
l - 一个用于接收绘制图层结束事件的监听器。

addLayerAddedListener

public void addLayerAddedListener(LayerAddedListener l)
添加一个用于接收图层被添加事件(LayerAddedEvent)的监听器。

参数:
l - 一个用于接收图层被添加事件的监听器。

removeLayerAddedListener

public void removeLayerAddedListener(LayerAddedListener l)
移除一个用于接收图层被添加事件(LayerAddedEvent)的监听器。

参数:
l - 一个用于接收图层被添加事件的监听器。

addLayerRemovedListener

public void addLayerRemovedListener(LayerRemovedListener l)
添加一个用于接收图层被删除事件(LayerRemovedEvent)的监听器。

参数:
l - 一个用于接收图层被删除事件的监听器。

removeLayerRemovedListener

public void removeLayerRemovedListener(LayerRemovedListener l)
移除一个用于接收图层被删除事件(LayerRemovedEvent)的监听器。

参数:
l - 一个用于接收图层被删除事件的监听器。

addLayerCaptionChangedListener

public void addLayerCaptionChangedListener(LayerCaptionChangedListener l)
添加一个用于接收图层标题变化事件(LayerCaptionChangedEvent)的监听器。

参数:
l - 一个用于接收图层标题变化事件的监听器。

removeLayerCaptionChangedListener

public void removeLayerCaptionChangedListener(LayerCaptionChangedListener l)
移除一个用于接收图层标题变化事件(LayerCaptionChangedEvent)的监听器。

参数:
l - 一个用于接收图层标题变化事件的监听器。

addLayerSelectableChangedListener

public void addLayerSelectableChangedListener(LayerSelectableChangedListener l)
添加一个用于接收图层可选择状态变化事件(LayerSelectableChangedEvent)的监听器。

参数:
l - 一个用于接收图层可选择状态变化事件的监听器。

removeLayerSelectableChangedListener

public void removeLayerSelectableChangedListener(LayerSelectableChangedListener l)
移除一个用于接收图层可选择状态变化事件(LayerSelectableChangedEvent)的监听器。

参数:
l - 一个用于接收图层可选择状态变化事件的监听器。

addLayerEditableChangedListener

public void addLayerEditableChangedListener(LayerEditableChangedListener l)
添加一个用于接收图层可编辑状态变化事件(LayerEditableChangedEvent)的监听器。

参数:
l - 一个用于接收图层可编辑状态变化事件的监听器。

removeLayerEditableChangedListener

public void removeLayerEditableChangedListener(LayerEditableChangedListener l)
移除一个用于接收图层可编辑状态变化事件(LayerEditableChangedEvent)的监听器。

参数:
l - 一个用于接收图层可编辑状态变化事件的监听器。

addLayerVisibleChangedListener

public void addLayerVisibleChangedListener(LayerVisibleChangedListener l)
添加一个用于接收图层可视状态改变事件(LayerVisibleChangedEvent)的监听器。

参数:
l - 一个用于接收图层可视状态改变事件的监听器。

removeLayerVisibleChangedListener

public void removeLayerVisibleChangedListener(LayerVisibleChangedListener l)
移除一个用于接收图层可视状态改变事件(LayerVisibleChangedEvent)的监听器。

参数:
l - 一个用于接收图层可视状态改变事件的监听器。

addLayerSnapableChangedListener

public void addLayerSnapableChangedListener(LayerSnapableChangedListener l)
添加一个用于接收图层可捕捉状态改变事件(LayerSnapableChangedEvent)的监听器。

参数:
l - 一个用于接收图层可捕捉状态改变事件的监听器。

removeLayerSnapableChangedListener

public void removeLayerSnapableChangedListener(LayerSnapableChangedListener l)
移除一个用于接收图层可捕捉状态改变事件(LayerSnapableChangedEvent)的监听器。

参数:
l - 一个用于接收图层可捕捉状态改变事件的监听器。

addChart

public Layer addChart(DatasetGroup datasetGroup,
                      boolean addToHead)
用于将一个数据集分组添加到地图的图层集中,以增加一个海图图层。

参数:
datasetGroup - 指定的数据集分组。
addToHead - 指定新添加的图层是否放在图层集合的最上面一层。当设置为 false 时,则将此新添加图层放在最底层。
返回:
海图图层。
示例:
以下代码示范了如何添加一幅海图图层到当前地图上。本例使用示范数据中的 Chart.smwu 工作空间,其中名为 SrcDatasource 的数据源中存在一个 名为 GB4X0000_52000 的数据集分组。本例将该数据集分组添加到地图图层集合中,即添加一个海图图层。使用如下代码时,请确保在您的项目中 存在一个名为 m_mapControl 的地图控件,并与所使用的工作空间相关联。
        /**
         * 根据给定的数据集分组添加海图图层。
         */
        private void addChartExample() {
                //打开工作空间
                Workspace workspace = new Workspace();
                WorkspaceConnectionInfo info = new WorkspaceConnectionInfo("产品安装目录/SampleData/Chart/Chart.smwu");
                workspace.open(info);
                m_mapControl.getMap().setWorkspace(workspace);

                //获得海图所在数据源
                Datasource datasource = workspace.getDatasources().get("SrcDatasource");

                //获得海图数据集分组
                DatasetGroup datasetGroup = datasource.getRootGroup().getChildGroups().get("GB4X0000_52000");

                //将数据集分组添加到地图上以得到一个海图图层
                LayerChart layerChart = (LayerChart)m_mapControl.getMap().getLayers().addChart(datasetGroup, true);

                m_mapControl.getMap().setAntialias(true);
                m_mapControl.getMap().viewEntire();
                m_mapControl.getMap().refresh();
        }
 

addGroup

public LayerGroup addGroup(java.lang.String groupName)
向图层集合中添加一个分组图层。

参数:
groupName - 分组图层的显示名称。
返回:
返回添加的分组图层。

insertGroup

public LayerGroup insertGroup(int index,
                              java.lang.String groupName)
向图层集合中插入一个分组图层。

参数:
index - 指定的插入分组图层的位置。
groupName - 分组图层的显示名称。
返回:
返回插入的分组图层。

removeGroup

public boolean removeGroup(LayerGroup group)
从图层集合中移除指定的分组图层。

参数:
group - 指定的要移除的分组图层。
返回:
一个布尔值,指示移除分组图层是否成功,true表示成功,false表示失败。

add

public boolean add(Layer layer)
向图层集合中添加一个图层。

参数:
layer - 指定的要添加的图层。
返回:
一个布尔值,指示添加图层是否成功,true表示成功,false表示失败。

insert

public boolean insert(int index,
                      Layer layer)
向图层集合中的指定索引位置插入一个图层。

参数:
index - 指定的插入图层的索引位置。
layer - 指定的要插入的图层。
返回:
一个布尔值,指示插入图层是否成功,true表示成功,false表示失败。

remove

public boolean remove(Layer layer)
从图层集合中移除一个指定的图层。

参数:
layer - 指定的要移除的图层。
返回:
一个布尔值,指示移除图层是否成功,true表示成功,false表示失败。

addLayerGroupAddedListener

public void addLayerGroupAddedListener(LayerGroupAddedListener l)
添加一个用于接收向图层集合中添加分组图层结束事件(LayerGroupAddedEvent)的监听器。

参数:
l - 一个用于接收向图层集合中添加分组图层结束事件的监听器。

removeLayerGroupAddedListener

public void removeLayerGroupAddedListener(LayerGroupAddedListener l)
移除一个用于接收向图层集合中添加分组图层结束事件(LayerGroupAddedEvent)的监听器。

参数:
l - 一个用于接收向图层集合中添加分组图层结束事件的监听器。

addLayerGroupRemovedListener

public void addLayerGroupRemovedListener(LayerGroupRemovedListener l)
添加一个用于接收从图层集合移除分组图层结束事件(LayerGroupRemovedEvent)的监听器。

参数:
l - 一个用于接收从图层集合移除分组图层结束事件的监听器。

removeLayerGroupRemovedListener

public void removeLayerGroupRemovedListener(LayerGroupRemovedListener l)
移除一个用于接收从图层集合移除分组图层结束事件(LayerGroupRemovedEvent)的监听器。

参数:
l - 一个用于接收从图层集合移除分组图层结束事件的监听器。

getAvailableCaption

public java.lang.String getAvailableCaption(java.lang.String layerCaption)
返回一个可用的图层显示名称。

参数:
layerCaption - 给定的图层显示名称。
返回:
返回一个可用的图层显示名称。

findLayer

public Layer findLayer(java.lang.String layerName)
返回指定的图层名称的图层对象。

参数:
layerName - 指定的图层名称。
返回:
返回指定的图层名称的图层对象。

AddCache

public LayerCache AddCache(java.lang.String sciFile,
                           boolean addToHead)
根据缓存配置文件创建一个多版本缓存图层( LayerCache对象)。

参数:
sciFile - 多版本缓存图层中连接的缓存的配置文件。
addToHead - 新添加的图层是否放在图层集合的最上面一层。为false时,则将此新添加图层放在最底层。
返回:
返回创建成功的多版本缓存图层( LayerCache对象)。

AddCache

public LayerCache AddCache(java.lang.String server,
                           java.lang.String database,
                           java.lang.String name,
                           boolean addToHead)
参数:
server - 多版本缓存图层中连接的缓存所在的服务器。
database - 多版本缓存图层中连接的缓存所在的数据库名称。
name - 多版本缓存图层中连接的缓存的名称。
addToHead - 新添加的图层是否放在图层集合的最上面一层。为false时,则将此新添加图层放在最底层。
返回:
返回创建成功的多版本缓存图层( LayerCache对象)。

AddCache

public LayerCache AddCache(java.lang.String server,
                           java.lang.String database,
                           java.lang.String name,
                           boolean addToHead,
                           java.lang.String user,
                           java.lang.String pwd)
参数:
server - 多版本缓存图层中连接的缓存所在的服务器。
database - 多版本缓存图层中连接的缓存所在的数据库名称。
name - 多版本缓存图层中连接的缓存的名称。
addToHead - 新添加的图层是否放在图层集合的最上面一层。为false时,则将此新添加图层放在最底层。
user - 数据库访问用户名。
pwd - 数据库访问密码。
返回:
返回创建成功的多版本缓存图层( LayerCache对象)。

insertLayerSnapshot

public LayerSnapshot insertLayerSnapshot(int index,
                                         java.lang.String snapshotName)
从图层集合中插入一个快照图层。

参数:
index - 指定的插入索引位置。
snapshotName - 插入的快照图层的显示名称。
返回:
返回插入的快照图层。

addLayerSnapshotAddedListener

public void addLayerSnapshotAddedListener(LayerSnapshotAddedListener l)
添加一个用于接收添加快照图层事件(LayerSnapshotAddedEvent)的监听器。

参数:
l - 一个用于接收添加快照图层事件的监听器。

removeLayerSnapshotAddedListener

public void removeLayerSnapshotAddedListener(LayerSnapshotAddedListener l)
移除一个用于接收添加快照图层事件(LayerSnapshotAddedEvent)的监听器。

参数:
l - 一个用于接收添加快照图层事件的监听器。

addLayerSnapshotRemovedListener

public void addLayerSnapshotRemovedListener(LayerSnapshotRemovedListener l)
添加一个用于接收移除快照图层事件(LayerSnapshotRemovedEvent)的监听器。

参数:
l - 一个用于接收移除快照图层事件的监听器。

removeLayerSnapshotRemovedListener

public void removeLayerSnapshotRemovedListener(LayerSnapshotRemovedListener l)
移除一个用于接收移除快照图层事件(LayerSnapshotRemovedEvent)的监听器。

参数:
l - 一个用于接收移除快照图层事件的监听器。

AddHeatmap

public LayerHeatmap AddHeatmap(Dataset dataset,
                               int kernelRadius)
根据给定的点数据集和参数设置制作一幅热力图,也就是将给定的点数据以热力图的渲染方式进行显示。

参数:
dataset - 参与制作热力图的数据,该数据必须为点矢量数据集。
kernelRadius - 用于计算密度的查找半径。
返回:
返回热力图图层对象。

AddHeatmap

public LayerHeatmap AddHeatmap(Dataset dataset,
                               int kernelRadius,
                               java.awt.Color maxColor,
                               java.awt.Color minColor)
根据给定的点数据集和参数设置制作一幅热力图,也就是将给定的点数据以热力图的渲染方式进行显示。

热力图是通过颜色分布,描述诸如人群分布、密度和变化趋势等的一种地图表现手法,因此,能够非常直观地呈现一些原本不易理解或表达的数据,比如密度、频度、温度等。

热力图图层除了可以反映点要素的相对密度,还可以表示根据属性进行加权的点密度,以此考虑点本身的权重对于密度的贡献。

参数:
dataset - 参与制作热力图的数据,该数据必须为点矢量数据集。
kernelRadius - 用于计算密度的查找半径。
maxColor - 高点密度的颜色。热力图图层将通过高点密度颜色(maxColor)和低点密度颜色(minColor)确定渐变的颜色方案。
minColor - 低点密度的颜色。热力图图层将通过高点密度颜色(maxColor)和低点密度颜色(minColor)确定渐变的颜色方案。
返回:
返回热力图图层对象。

AddHeatmap

public LayerHeatmap AddHeatmap(MemRecordset recordset,
                               int kernelRadius)
根据给定的内存点记录集和参数设置制作一幅热力图,也就是将给定的点数据以热力图的渲染方式进行显示。

参数:
recordset - 参与制作热力图的数据,必须为内存点记录集。
kernelRadius - 用于计算密度的查找半径。
返回:
返回热力图图层对象。

AddHeatmap

public LayerHeatmap AddHeatmap(MemRecordset recordset,
                               int kernelRadius,
                               java.awt.Color maxColor,
                               java.awt.Color minColor)
根据给定的内存点记录集和参数设置制作一幅热力图,也就是将给定的点数据以热力图的渲染方式进行显示。

参数:
recordset - 参与制作热力图的数据,必须为内存点记录集。
kernelRadius - 用于计算密度的查找半径。
maxColor - 高点密度的颜色。热力图图层将通过高点密度颜色(maxColor)和低点密度颜色(minColor)确定渐变的颜色方案。
minColor - 低点密度的颜色。热力图图层将通过高点密度颜色(maxColor)和低点密度颜色(minColor)确定渐变的颜色方案。
返回:
返回热力图图层对象。

AddGridAggregation

public LayerGridAggregation AddGridAggregation(Dataset dataset)
根据给定的点数据集制作一幅默认风格的网格聚合图。

参数:
dataset - 参与制作网格聚合图的数据,该数据必须为点矢量数据集。
返回:
返回网格聚合图图层对象。

AddGridAggregation

public LayerGridAggregation AddGridAggregation(Dataset dataset,
                                               java.awt.Color maxColor,
                                               java.awt.Color minColor)
根据给定的点数据集和参数设置制作一幅网格聚合图,也就是将给定的点数据以网格聚合图的渲染方式进行显示。

参数:
dataset - 参与制作网格聚合图的数据,该数据必须为点矢量数据集。
maxColor - 网格单元统计值最大值对应的颜色,网格聚合图将通过maxColor和minColor确定渐变的颜色方案,然后基于网格单元统计值大小排序,对网格单元进行颜色渲染。
minColor - 网格单元统计值最小值对应的颜色,网格聚合图将通过maxColor和minColor确定渐变的颜色方案,然后基于网格单元统计值大小排序,对网格单元进行颜色渲染。
返回:
返回网格聚合图图层对象。

AddGridAggregation

public LayerGridAggregation AddGridAggregation(MemRecordset recordset)
根据给定的内存点记录集制作一幅默认风格的网格聚合图。

参数:
recordset - 参与制作网格聚合图的数据,必须为点对象。
返回:
返回网格聚合图图层对象。

AddGridAggregation

public LayerGridAggregation AddGridAggregation(MemRecordset recordset,
                                               java.awt.Color maxColor,
                                               java.awt.Color minColor)
根据给定的内存点记录集和参数设置制作一幅网格聚合图,也就是将给定的点数据以网格聚合图的渲染方式进行显示。

参数:
recordset - 参与制作网格聚合图的数据,必须为点对象。
maxColor - 网格单元统计值最大值对应的颜色,网格聚合图将通过maxColor和minColor确定渐变的颜色方案,然后基于网格单元统计值大小排序,对网格单元进行颜色渲染。
minColor - 网格单元统计值最小值对应的颜色,网格聚合图将通过maxColor和minColor确定渐变的颜色方案,然后基于网格单元统计值大小排序,对网格单元进行颜色渲染。
返回:
返回网格聚合图图层对象。

addMosaicGroup

public LayerMosaicGroup addMosaicGroup(DatasetMosaic datasetMosaic,
                                       java.lang.Boolean addToHead)
将一个镶嵌数据集添加到图层集合中作为一个镶嵌数据集图层分组进行显示。

参数:
datasetMosaic - 指定的镶嵌数据集。
addToHead - 是否添加到图层集合的最前面,true表示添加到集合中所有图层的前面。
返回:
返回添加的镶嵌数据集图层分组组。

insertMosaicGroup

public LayerMosaicGroup insertMosaicGroup(int index,
                                          DatasetMosaic datasetMosaic)
将一个镶嵌数据集插入到图层集合中作为一个镶嵌数据集图层分组进行显示。

参数:
index - 指定要插入的索引位置。
datasetMosaic - 指定的要插入的镶嵌数据集。
返回:
返回镶嵌数据集图层分组组。

insertLayer

public Layer insertLayer(int index,
                         java.lang.String layerXml)
在指定索引位置插入图层对象。

参数:
index - 指定插入的索引位置。
layerXml - 描述图层的XML格式字符串。
返回:
返回插入的图层对象。