MapOverlapDisplayedOptions (iObjects Java Help)

java.lang.Object
- com.supermap.data.InternalHandle
- - com.supermap.data.InternalHandleDisposable
  - - com.supermap.mapping.MapOverlapDisplayedOptions

所有已实现的接口:: IDisposable

public class MapOverlapDisplayedOptions
extends com.supermap.data.InternalHandleDisposable

地图压盖过滤显示选项类，在文本或专题图元素显示较密集的区域，文本之间或专题元素之间会发生相互压盖的现象，该类可以分别控制各种类型的对象的压盖显示情况，进而很好地处理地图中各种类型对象的压盖显示问题。

示范代码:

以下代码示范如何运用该类处理地图中各种类型对象的压盖显示问题。

 public void MapOverlapDisplayedOptionsTest(){
                
        // 打开工作空间 
        String path = "../world";
        Workspace workspace = new Workspace();
        WorkspaceConnectionInfo workspaceConnectionInfo = new WorkspaceConnectionInfo(path + "/world.sxw");
        workspace.open(workspaceConnectionInfo);
        
        //获取数据源，获取给定的数据集
        Datasource datasource = workspace.getDatasources().get("world");
        DatasetVector dataset = (DatasetVector) datasource.getDatasets().get("Capital");
        
        MapControl m_mapcontrol = new MapControl(workspace);
        Map map = m_mapcontrol.getMap();
                
        //添加数据集Capital到地图中
        map.getLayers().add(dataset, true);
                
        //设置重叠时不显示对象
        map.setOverlapDisplayed(false);
                
        //构造地图压盖过滤显示选项类 
        MapOverlapDisplayedOptions mapOverlapDisplayedOptions = map.getOverlapDisplayedOptions();
                
        //设置点和点压盖时不显示压盖的点对象
        mapOverlapDisplayedOptions.setAllowPointOverlap(false);
        //设置各对象之间的压盖间距
        mapOverlapDisplayedOptions.setOverlappedSpaceSize(new Size2D(40, 40));
        //设置地图的压盖过滤显示选项
        map.setOverlapDisplayedOptions(mapOverlapDisplayedOptions);
                
        //释放资源
        m_mapcontrol.dispose();
        workspace.close();
        workspace.dispose();
    }

构造器概要

构造器
构造器和说明

MapOverlapDisplayedOptions()
构造一个新的 MapOverlapDisplayedOptions 对象。

构造器
构造器和说明
`MapOverlapDisplayedOptions()` 构造一个新的 MapOverlapDisplayedOptions 对象。

方法概要

所有方法实例方法具体方法
限定符和类型	方法和说明
`void`	`dispose()` 释放对象所占用的资源。
`boolean`	`getAllowPointOverlap()` 返回点和点压盖时是否显示压盖的点对象。
`boolean`	`getAllowPointWithTextDisplay()` 返回标签和相应普通图层上的点是否一起过滤显示,如果过滤显示，只以图层集合中对应数据集的索引最小的图层的点风格来绘制点。
`boolean`	`getAllowTextAndPointOverlap()` 返回文本和点压盖时是否显示压盖的文本或点对象(此属性不处理文本之间的压盖和点之间的压盖)。
`boolean`	`getAllowTextOverlap()` 返回文本压盖时是否显示压盖的文本对象。
`boolean`	`getAllowTextWithPointDisplay()` 获取标签是否随符号显隐
`boolean`	`getAllowThemeGraduatedSymbolOverlap()` 返回等级符号元素压盖时是否显示压盖的等级符号元素。
`boolean`	`getAllowThemeGraphOverlap()` 返回统计专题图元素压盖时是否显示压盖的统计专题图元素。
`Size2D`	`getOverlappedSpaceSize()` 返回两个对象之间的压盖间距，为正数时表示两个对象之间的距离，为负数时表示两个对象的压盖距离。
`boolean`	`isObliqueRectEnabled()` 是否精确计算文本对象的范围。
`void`	`setAllowPointOverlap(boolean value)` 设置点和点压盖时是否显示压盖的点对象。
`void`	`setAllowPointWithTextDisplay(boolean value)` 设置标签和相应普通图层上的点是否一起过滤显示,如果过滤显示，只以图层集合中对应数据集的索引最小的图层的点风格来绘制点。
`void`	`setAllowTextAndPointOverlap(boolean value)` 设置文本和点压盖时是否显示压盖的文本或点对象(此属性不处理文本之间的压盖和点之间的压盖)。
`void`	`setAllowTextOverlap(boolean value)` 设置文本压盖时是否显示压盖的文本对象。
`void`	`setAllowTextWithPointDisplay(boolean value)` 设置标签是否随符号显隐
`void`	`setAllowThemeGraduatedSymbolOverlap(boolean value)` 设置等级符号元素压盖时是否显示压盖的等级符号元素。
`void`	`setAllowThemeGraphOverlap(boolean value)` 设置统计专题图元素压盖时是否显示压盖的统计专题图元素。
`void`	`setObliqueRectEnabled(boolean value)` 设置是否精确计算文本对象的范围。
`void`	`setOverlappedSpaceSize(Size2D value)` 设置两个对象之间的压盖间距，为正数时表示两个对象之间的距离，为负数时表示两个对象的压盖距离。

从类继承的方法 com.supermap.data.InternalHandleDisposable
makeSureNativeObjectLive

从类继承的方法 java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 构造器详细资料
  - MapOverlapDisplayedOptions
```
public MapOverlapDisplayedOptions()
```
    构造一个新的 MapOverlapDisplayedOptions 对象。
- 方法详细资料
  - dispose
```
public void dispose()
```
    释放对象所占用的资源。调用该方法之后，此对象不再可用。
  - getAllowTextOverlap
```
public boolean getAllowTextOverlap()
```
    返回文本压盖时是否显示压盖的文本对象。
    
    返回:
    
    返回false时，不显示压盖的文本对象，否则返回true。
    
    默认值:
    
    默认值为 false。
  - setAllowTextOverlap
```
public void setAllowTextOverlap(boolean value)
```
    设置文本压盖时是否显示压盖的文本对象。
    
    参数:
    
    value - 一个布尔值，用于指定是否显示压盖的文本对象，true,表示显示压盖的文本对象；false,表示不显示压盖的文本对象。
  - getAllowPointOverlap
```
public boolean getAllowPointOverlap()
```
    返回点和点压盖时是否显示压盖的点对象。
    
    返回:
    
    返回false时，不显示压盖的点对象，否则返回true。
    
    默认值:
    
    默认值为 true。
  - setAllowPointOverlap
```
public void setAllowPointOverlap(boolean value)
```
    设置点和点压盖时是否显示压盖的点对象。
    
    参数:
    
    value - 一个布尔值，用于指定是否显示压盖的点对象，true,表示显示压盖的点对象；false,表示不显示压盖的点对象。
  - getAllowTextAndPointOverlap
```
public boolean getAllowTextAndPointOverlap()
```
    返回文本和点压盖时是否显示压盖的文本或点对象(此属性不处理文本之间的压盖和点之间的压盖)。
    
    返回:
    
    返回false时，不显示压盖的对象，否则返回true。
    
    默认值:
    
    默认值为 true。
  - setAllowTextAndPointOverlap
```
public void setAllowTextAndPointOverlap(boolean value)
```
    设置文本和点压盖时是否显示压盖的文本或点对象(此属性不处理文本之间的压盖和点之间的压盖)。
    
    参数:
    
    value - 一个布尔值，用于指定是否显示压盖的文本或点对象，true,表示显示压盖的对象；false,表示不显示压盖的对象。
  - getAllowPointWithTextDisplay
```
public boolean getAllowPointWithTextDisplay()
```
    返回标签和相应普通图层上的点是否一起过滤显示,如果过滤显示，只以图层集合中对应数据集的索引最小的图层的点风格来绘制点。
    注意，这里的普通图层包括相应点数据集的所有普通图层和单值、分段、自定义专题图图层。
    
    如果该方法的返回值为true时，对于点图层的标签专题图存在这样的现象，如果该标签专题图使用了过滤表达式，那么地图中该点数据集（该标签专题图基于的点数据集）对应的其他图层都将采用该标签专题图的过滤表达式进行显示；如果实际应用中不需要这样的过滤显示效果，而是需要该点数据集所对应的图层采用各自的过滤表达式，那么需要通过 setAllowPointWithTextDisplay()方法传入 false参数值。
    
    当一个点数据集被多次添加到一幅地图中，并且设置了不同的点符号风格，且基于这些图层制作了各自风格的标签专题图，同时，各个点图层还设置了不同的过滤显示条件，基于上述情况，如果 getAllowPointWithTextDisplay 方法返回值为 true，则上述这些点图层将以其中位于最上层的点图层风格进行绘制，而这些点图层的标签专题图仍按各自设置的风格进行绘制。
    
    返回:
    
    标签和相应普通图层上的点一起过滤显示返回true，否则返回false。
    
    默认值:
    
    默认值为 true。
  - setAllowPointWithTextDisplay
```
public void setAllowPointWithTextDisplay(boolean value)
```
    设置标签和相应普通图层上的点是否一起过滤显示,如果过滤显示，只以图层集合中对应数据集的索引最小的图层的点风格来绘制点。
    注意，这里的普通图层包括相应点数据集的所有普通图层和单值、分段、自定义专题图图层。
    
    如果 setAllowPointWithTextDisplay()方法传入的参数值为true时，对于点图层的标签专题图存在这样的现象，如果该标签专题图使用了过滤表达式，那么地图中该点数据集（该标签专题图基于的点数据集）对应的其他图层都将采用该标签专题图的过滤表达式进行显示；如果实际应用中不需要这样的过滤显示效果，而是需要该点数据集对应的图层采用各自的过滤表达式，那么需要通过 setAllowPointWithTextDisplay()方法传入 false参数值。
    
    当一个点数据集被多次添加到一幅地图中，并且设置了不同的点符号风格，且基于这些图层制作了各自风格的标签专题图，同时，各个点图层还设置了不同的过滤显示条件，基于上述情况，如果通过 setAllowPointWithTextDisplay() 方法设置了标签随点对象一起过滤显示（即该方法传入参数 true），则上述这些点图层将以其中位于最上层的点图层风格进行绘制，而这些点图层的标签专题图仍按各自设置的风格进行绘制。
    
    参数:
    
    value - 一个布尔值，用于指定标签和相应普通图层上的点是否一起过滤显示，true,表示标签和相应普通图层上的点一起过滤显示；false,表示标签和相应普通图层上的点不一起过滤显示。
  - getAllowTextWithPointDisplay
```
public boolean getAllowTextWithPointDisplay()
```
    获取标签是否随符号显隐
    
    返回:
    
    是否随符号显隐
  - setAllowTextWithPointDisplay
```
public void setAllowTextWithPointDisplay(boolean value)
```
    设置标签是否随符号显隐
    
    参数:
    
    value - 是否随符号显隐
  - getAllowThemeGraduatedSymbolOverlap
```
public boolean getAllowThemeGraduatedSymbolOverlap()
```
    返回等级符号元素压盖时是否显示压盖的等级符号元素。
    
    返回:
    
    等级符号元素压盖时显示压盖的等级符号元素返回true,否则返回false。
    
    默认值:
    
    默认值为 false。
  - setAllowThemeGraduatedSymbolOverlap
```
public void setAllowThemeGraduatedSymbolOverlap(boolean value)
```
    设置等级符号元素压盖时是否显示压盖的等级符号元素。
    
    参数:
    
    value - 一个布尔值，用于指定等级符号元素压盖时是否显示压盖的等级符号元素，true,表示显示压盖的等级符号元素；false,表示不显示压盖的等级符号元素。
  - getAllowThemeGraphOverlap
```
public boolean getAllowThemeGraphOverlap()
```
    返回统计专题图元素压盖时是否显示压盖的统计专题图元素。
    
    返回:
    
    统计专题图元素压盖时显示压盖的统计专题图元素返回true,否则返回false。
    
    默认值:
    
    默认值为 false。
  - setAllowThemeGraphOverlap
```
public void setAllowThemeGraphOverlap(boolean value)
```
    设置统计专题图元素压盖时是否显示压盖的统计专题图元素。
    
    参数:
    
    value - 一个布尔值，用于指定统计专题图元素压盖时是否显示压盖的统计专题图元素，true,表示显示压盖的统计专题图元素；false,表示不显示压盖的统计专题图元素。
  - getOverlappedSpaceSize
```
public Size2D getOverlappedSpaceSize()
```
    返回两个对象之间的压盖间距，为正数时表示两个对象之间的距离，为负数时表示两个对象的压盖距离。
    压盖间距的单位为0.1毫米。压盖间距为正数时表示两个对象之间的距离，超出距离时显示，小于等于该距离时不显示；为负数时表示两个对象的压盖距离，小于该距离的绝对值时显示，大于等于该距离的绝对值时不显示。
    
    返回:
    
    两个对象之间的重叠间距。
    
    默认值:
    
    默认值为 (0,0)。
  - setOverlappedSpaceSize
```
public void setOverlappedSpaceSize(Size2D value)
```
    设置两个对象之间的压盖间距，为正数时表示两个对象之间的距离，为负数时表示两个对象的压盖距离。
    压盖间距的单位为0.1毫米。压盖间距为正数时表示两个对象之间的距离，超出距离的显示，小于等于该距离的不显示；为负数时表示两个对象的压盖距离，小于该距离的绝对值时显示，大于等于该距离的绝对值时不显示。
    
    参数:
    
    value - 两个对象之间的压盖间距。
  - isObliqueRectEnabled
```
public boolean isObliqueRectEnabled()
```
    是否精确计算文本对象的范围。为 true时，支持精确计算文本数据集图层中具有旋转角度的文本对象的范围，避免不合理的文本压盖情况，从而显示更多的文本对象。精确计算文本对象的范围，会对地图绘制性能有一定的影响，用户可根据实际数据情况确认是否启用精确计算文本对象范围。
    下图示意了未精确计算文本对象范围与精确计算文本对象范围下，文本对象的范围（Bounds）情况。
    
    返回:
    
    一个布尔值，指示是否精确计算文本数据集图层中具有旋转角度的文本对象的范围。
  - setObliqueRectEnabled
```
public void setObliqueRectEnabled(boolean value)
```
    设置是否精确计算文本对象的范围。当设置为 true时，支持精确计算文本数据集图层中具有旋转角度的文本对象的范围，避免不合理的文本压盖情况，从而显示更多的文本对象。当设置为true时，将精确计算文本对象的范围，所以地图绘制性能会有一定的影响，因此，此设置默认值为false，用户可根据实际数据情况确认是否启用精确计算文本对象范围。
    下图示意了未精确计算文本对象范围与精确计算文本对象范围下，文本对象的范围（Bounds）情况。
    
    参数:
    
    value - 一个布尔值，指示是否精确计算文本数据集图层中具有旋转角度的文本对象的范围。

类 MapOverlapDisplayedOptions

构造器概要

方法概要

从类继承的方法 com.supermap.data.InternalHandleDisposable

从类继承的方法 java.lang.Object

构造器详细资料

MapOverlapDisplayedOptions

方法详细资料

dispose

getAllowTextOverlap

setAllowTextOverlap

getAllowPointOverlap

setAllowPointOverlap

getAllowTextAndPointOverlap

setAllowTextAndPointOverlap

getAllowPointWithTextDisplay

setAllowPointWithTextDisplay

getAllowTextWithPointDisplay

setAllowTextWithPointDisplay

getAllowThemeGraduatedSymbolOverlap

setAllowThemeGraduatedSymbolOverlap

getAllowThemeGraphOverlap

setAllowThemeGraphOverlap

getOverlappedSpaceSize

setOverlappedSpaceSize

isObliqueRectEnabled

setObliqueRectEnabled