com.supermap.mapping
类 ChartSetting

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

public class ChartSetting
extends java.lang.Object

海图显示参数设置类,用于管理海图显示环境,包括海图的显示模式、显示类型名称、颜色模式、安全水深线等各种显示风格。

示例:
以下代码示范了如何对海图显示风格进行自定义设置,这里仅列举海图显示风格的部分设置。使用本示例代码,请确保在您的项目中存在一个名为“ m_mapControl”的地图控件(MapControl),并且与当前工作空间相关联。
 public void customChartSetting() {
        //设置海图显示的颜色模式为“晨昏”模式
        m_mapControl.getMap().getChartSetting().setColourModeChart(
                        com.supermap.mapping.ColourModeChart.DUSK);
 
        //设置深水等深线为50.0
        m_mapControl.getMap().getChartSetting().setDeepContour(50.0);
 
        //设置海图显示模式为“基本显示模式”
        m_mapControl.getMap().getChartSetting().setDisplayModeChart(
                        DisplayModeChart.BASIC);
 
        //设置海图显示类型的名称
        m_mapControl.getMap().getChartSetting().setDisplayTypeName("S52");
 
        //设置是否显示图幅编号
        m_mapControl.getMap().getChartSetting().isDisplayCellName();
 
        //设置浅水等深线为2.0
        m_mapControl.getMap().getChartSetting().setShallowContour(2.0);
 
        m_mapControl.getMap().refresh();
 }
 

方法摘要
 ColourModeChart getColourModeChart()
          返回海图显示的颜色模式。
 double getDeepContour()
          返回深水等深线。
 Unit getDepthUnit()
          返回显示水深单位。
 java.util.Map<java.lang.String,java.lang.Boolean> getDisplayableFeature()
          返回当前地图下所有物标类型是否可显示的对应关系。
 DisplayModeChart getDisplayModeChart()
          返回海图显示模式。
 java.lang.String getDisplayTypeName()
          返回海图显示类型的名称,如 "S52"、"IENC" 、"INT"。
 java.lang.String getFontName()
          返回海图上显示文本的字体名称。
 double getFontSize()
          返回海图上文本显示字体的字号。
 double getSafetyContour()
          返回安全等深线。
 double getSafetyDepth()
          返回安全水深值。
 java.util.Map<java.lang.String,java.lang.Boolean> getSelectableFeature()
          返回当前地图下所有物标类型是否可选择的对应关系。
 GeoStyle getSelectionStyle()
          返回选中物标的高亮显示风格。
 double getShallowContour()
          返回浅水等深线。
 boolean isDisplayCellName()
          返回是否显图幅编号。
 boolean isDisplayLowAccurateMarker()
          返回是否显示低精度符号。
 boolean isDisplayMetaObject()
          返回是否显示元物标。
 boolean isDisplayOtherContourLabel()
          返回是否显示其他等深线标注,即安全水深线标注以外的标注。
 boolean isDisplaySafetyContourLabel()
          返回是否显示安全等深线标注。
 boolean isDisplaySounding()
          返回是否显示水深点。
 boolean isDisplayTextMessage()
          返回是否在海图上显示文本信息。
 boolean isDisplayTwoShades()
          返回是否以两色模式显示水深面。
 boolean isLocalizationDisplayText()
          返回是否对文本进行本地化显示。
 boolean isMinVisibleScaleEnabled()
          返回物标的最小可见比例尺是否有效。
 boolean isSimplifiedMarker()
          返回是否使用简单海图符号。
 boolean isSymbolizedAreaBoundary()
          返回是否使用符号化的区域边界。
 boolean isTextClipRegionEnabled()
          返回是否启用海图图层的文本显示裁剪区。
 void setColourModeChart(ColourModeChart mode)
          设置海图显示的颜色模式。
 void setDeepContour(double value)
          设置深水等深线。
 void setDepthUnit(Unit value)
          设置显示水深单位。
 void setDisplayableFeature(java.util.Map<java.lang.String,java.lang.Boolean> value)
          设置当前地图下所有物标类型是否可显示的对应关系。
 void setDisplayCellName(boolean value)
          设置是否显图幅编号。
 void setDisplayLowAccurateMarker(boolean value)
          设置是否显示低精度符号。
 void setDisplayMetaObject(boolean value)
          设置是否显示元物标。
 void setDisplayModeChart(DisplayModeChart mode)
          设置海图显示模式。
 void setDisplayOtherContourLabel(boolean value)
          设置是否显示其他等深线标注,即安全水深线标注以外的标注。
 void setDisplaySafetyContourLabel(boolean value)
          设置是否显示安全等深线标注。
 void setDisplaySounding(boolean value)
          设置是否显示水深点。
 void setDisplayTextMessage(boolean value)
          设置是否在海图上显示文本信息。
 void setDisplayTwoShades(boolean value)
          设置是否以两色模式显示水深面。
 void setDisplayTypeName(java.lang.String value)
          设置海图显示类型的名称,如 "S52"、"IENC"、"INT"。
 void setFontName(java.lang.String value)
          设置海图上显示文本的字体名称。
 void setFontSize(double value)
          设置海图上文本显示字体的字号。
 void setLocalizationDisplayText(boolean value)
          设置是否对文本进行本地化显示。
 void setMinVisibleScaleEnabled(boolean value)
          设置物标的最小可见比例尺是否有效。
 void setSafetyContour(double value)
          设置安全等深线。
 void setSafetyDepth(double value)
          设置安全水深值。
 void setSelectableFeature(java.util.Map<java.lang.String,java.lang.Boolean> value)
          设置当前地图下所有物标类型是否可选择的对应关系。
 void setSelectionStyle(GeoStyle value)
          设置选中物标的高亮显示风格。
 void setShallowContour(double value)
          设置浅水等深线。
 void setSimplifiedMarker(boolean value)
          设置是否使用简单海图符号。
 void setSymbolizedAreaBoundary(boolean value)
          设置是否使用符号化的区域边界。
 void setTextClipRegionEnabled(boolean value)
          设置是否启用海图图层的文本显示裁剪区。
 
从类 java.lang.Object 继承的方法
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

方法详细信息

setDisplayModeChart

public void setDisplayModeChart(DisplayModeChart mode)
设置海图显示模式。

参数:
mode - 海图显示模式。

getDisplayModeChart

public DisplayModeChart getDisplayModeChart()
返回海图显示模式。

返回:
海图显示模式。
默认值:
默认值为 DisplayModeChart.STANDARD

setColourModeChart

public void setColourModeChart(ColourModeChart mode)
设置海图显示的颜色模式。

参数:
mode - 颜色模式。

getColourModeChart

public ColourModeChart getColourModeChart()
返回海图显示的颜色模式。

返回:
颜色模式。
默认值:
默认值为 ColourModeChart.DAY_BRIGHT

setDisplayTypeName

public void setDisplayTypeName(java.lang.String value)
设置海图显示类型的名称,如 "S52"、"IENC"、"INT"。

参数:
value - 海图显示类型的名称。

getDisplayTypeName

public java.lang.String getDisplayTypeName()
返回海图显示类型的名称,如 "S52"、"IENC" 、"INT"。

返回:
海图显示类型的名称。
默认值:
默认值为 "S52"。

setFontName

public void setFontName(java.lang.String value)
设置海图上显示文本的字体名称。

参数:
value - 显示文本的字体名称。

getFontName

public java.lang.String getFontName()
返回海图上显示文本的字体名称。

返回:
显示文本的字体名称。
默认值:
默认值为 "Arial"。

setSimplifiedMarker

public void setSimplifiedMarker(boolean value)
设置是否使用简单海图符号。

参数:
value - 一个布尔值,该值指示是否使用简单海图符号,true 表示使用简单海图符号;false 表示使用传统纸海图符号。

isSimplifiedMarker

public boolean isSimplifiedMarker()
返回是否使用简单海图符号。

返回:
一个布尔值,该值指示是否使用简单海图符号,true 表示使用简单海图符号;false 表示使用传统纸海图符号。
默认值:
默认值为 true。

setSymbolizedAreaBoundary

public void setSymbolizedAreaBoundary(boolean value)
设置是否使用符号化的区域边界。

参数:
value - 一个布尔值,该值指示是否使用符号化的区域边界,true 表示使用符号化的区域边界,false 表示不使用。

isSymbolizedAreaBoundary

public boolean isSymbolizedAreaBoundary()
返回是否使用符号化的区域边界。

返回:
一个布尔值,该值指示是否使用符号化的区域边界,true 表示使用符号化的区域边界,false 表示不使用。
默认值:
默认值为 false。

setDisplayTextMessage

public void setDisplayTextMessage(boolean value)
设置是否在海图上显示文本信息。

参数:
value - 一个布尔值,该值指示是否在海图上显示文本信息,true 表示显示,false 表示不显示。

isDisplayTextMessage

public boolean isDisplayTextMessage()
返回是否在海图上显示文本信息。

返回:
一个布尔值,该值指示是否在海图上显示文本信息,true 表示显示,false 表示不显示。
默认值:
默认值为 false。

setDisplaySounding

public void setDisplaySounding(boolean value)
设置是否显示水深点。

当将显示模式设置为OTHER时,该方法才有效。

参数:
value - 一个布尔值,该值指示是否显示水深点,true 表示显示,false 表示不显示。

isDisplaySounding

public boolean isDisplaySounding()
返回是否显示水深点。

返回:
一个布尔值,该值指示是否显示水深点,true 表示显示,false 表示不显示。
默认值:
默认值为 false。

setMinVisibleScaleEnabled

public void setMinVisibleScaleEnabled(boolean value)
设置物标的最小可见比例尺是否有效。

物标的最小可见比例尺大于当前地图的比例尺,且该方法设置为 true 时,表示物标不显示,否则,表示物标显示。

参数:
value - 一个布尔值,该值指示物标的最小可见比例尺是否有效,true 表示有效,false 表示无效。

isMinVisibleScaleEnabled

public boolean isMinVisibleScaleEnabled()
返回物标的最小可见比例尺是否有效。

物标的最小可见比例尺大于当前地图的比例尺,且该方法返回为 true 时,表示物标不显示,否则,表示物标显示。

返回:
一个布尔值,该值指示物标的最小可见比例尺是否有效,true 表示有效,false 表示无效。
默认值:
默认值为 true。

setLocalizationDisplayText

public void setLocalizationDisplayText(boolean value)
设置是否对文本进行本地化显示。

参数:
value - 一个布尔值,该值指示是否对文本进行本地化显示,true 表示对文本进行本地化显示,false 表示不进行本地化显示。

isLocalizationDisplayText

public boolean isLocalizationDisplayText()
返回是否对文本进行本地化显示。

返回:
一个布尔值,该值指示是否对文本进行本地化显示,true 表示对文本进行本地化显示,false 表示不进行本地化显示。
默认值:
默认值为 false。

isDisplayMetaObject

public boolean isDisplayMetaObject()
返回是否显示元物标。

返回:
一个布尔值,该值指示是否显示元物标,true 表示显示元物标,false 表示不显示。
默认值:
默认值为 false。

setDisplayMetaObject

public void setDisplayMetaObject(boolean value)
设置是否显示元物标。

当将显示模式设置为OTHER时,该方法才有效。

参数:
value - 一个布尔值,该值指示是否显示元物标,true 表示显示元物标,false 表示不显示。

isDisplayCellName

public boolean isDisplayCellName()
返回是否显图幅编号。

返回:
一个布尔值,该值指示是否显图幅编号,true 表示显示图幅编号,false 表示不显示。
默认值:
默认值为 false。

setDisplayCellName

public void setDisplayCellName(boolean value)
设置是否显图幅编号。

参数:
value - 一个布尔值,该值指示是否显图幅编号,true 表示显示图幅编号,false 表示不显示。

setDisplaySafetyContourLabel

public void setDisplaySafetyContourLabel(boolean value)
设置是否显示安全等深线标注。

参数:
value - 一个布尔值,该值指示是否显示安全等深线标注,true 表示显示,false 表示不显示。
默认值:
默认值为 true。

isDisplaySafetyContourLabel

public boolean isDisplaySafetyContourLabel()
返回是否显示安全等深线标注。

返回:
一个布尔值,该值指示是否显示安全等深线标注,true 表示显示,false 表示不显示。
默认值:
默认值为 true。

getSafetyContour

public double getSafetyContour()
返回安全等深线。单位以 setDepthUnit 方法设置的水深单位为准。

返回:
安全等深线。
默认值:
默认值为 30.0。

setSafetyContour

public void setSafetyContour(double value)
设置安全等深线。单位以 setDepthUnit 方法设置的水深单位为准。

参数:
value - 安全等深线。

setShallowContour

public void setShallowContour(double value)
设置浅水等深线。单位以 setDepthUnit 方法设置的水深单位为准。

参数:
value - 浅水等深线。

getShallowContour

public double getShallowContour()
返回浅水等深线。单位以 setDepthUnit 方法设置的水深单位为准。

返回:
浅水等深线。
默认值:
默认值为 2.0。

setDeepContour

public void setDeepContour(double value)
设置深水等深线。单位以 setDepthUnit 方法设置的水深单位为准。

参数:
value - 深水等深线。

getDeepContour

public double getDeepContour()
返回深水等深线。单位以 setDepthUnit 方法设置的水深单位为准。

返回:
深水等深线。
默认值:
默认值为 30.0。

setSafetyDepth

public void setSafetyDepth(double value)
设置安全水深值。单位以 setDepthUnit 方法设置的水深单位为准。

参数:
value - 安全水深值。

getSafetyDepth

public double getSafetyDepth()
返回安全水深值。单位以 setDepthUnit 方法设置的水深单位为准。

返回:
安全水深值。
默认值:
默认为 30.0。

setDisplayOtherContourLabel

public void setDisplayOtherContourLabel(boolean value)
设置是否显示其他等深线标注,即安全水深线标注以外的标注。

当将显示模式设置为OTHER时,该方法才有效。

参数:
value - 一个布尔值,该值指示是否显示其他等深线标注,true 表示显示,false 表示不显示。

isDisplayOtherContourLabel

public boolean isDisplayOtherContourLabel()
返回是否显示其他等深线标注,即安全水深线标注以外的标注。

返回:
一个布尔值,该值指示是否显示其他等深线标注,true 表示显示,false 表示不显示。
默认值:
默认值为 false。

setDisplayTwoShades

public void setDisplayTwoShades(boolean value)
设置是否以两色模式显示水深面。

参数:
value - 一个布尔值,该值指示是否以两色模式显示水深面,true 表示以两色模式显示,false 表示以四色模式显示。

isDisplayTwoShades

public boolean isDisplayTwoShades()
返回是否以两色模式显示水深面。

返回:
一个布尔值,该值指示是否以两色模式显示水深面,true 表示以两色模式显示,false 表示以四色模式显示。
默认值:
默认值为 false,即以四色模式显示水深面。

setDepthUnit

public void setDepthUnit(Unit value)
设置显示水深单位。

在航海上常用的单位为分米、米和英尺。目前仅支持DECIMETERMETERFOOT

参数:
value - 显示水深单位。

getDepthUnit

public Unit getDepthUnit()
返回显示水深单位。

在航海上常用的单位为分米、米和英尺。目前仅支持DECIMETERMETERFOOT

返回:
显示水深单位。
默认值:
默认值为 Unit.METER

setFontSize

public void setFontSize(double value)
设置海图上文本显示字体的字号。

参数:
value - 文本显示字体的字号。

getFontSize

public double getFontSize()
返回海图上文本显示字体的字号。

返回:
文本显示字体的字号。
默认值:
默认值为 10.0。

getSelectionStyle

public GeoStyle getSelectionStyle()
返回选中物标的高亮显示风格。

返回:
选中物标的高亮显示风格。

setSelectionStyle

public void setSelectionStyle(GeoStyle value)
设置选中物标的高亮显示风格。

参数:
value - 选中物标的高亮显示风格。

getDisplayableFeature

public java.util.Map<java.lang.String,java.lang.Boolean> getDisplayableFeature()
返回当前地图下所有物标类型是否可显示的对应关系。

返回:
当前地图下所有物标类型是否可显示的对应关系。

setDisplayableFeature

public void setDisplayableFeature(java.util.Map<java.lang.String,java.lang.Boolean> value)
设置当前地图下所有物标类型是否可显示的对应关系。

设置物标是否可显示的对应关系时,需要先获得原来物标类型是否可显示的对应关系。

参数:
value - 当前地图下所有物标类型是否可显示的对应关系。

getSelectableFeature

public java.util.Map<java.lang.String,java.lang.Boolean> getSelectableFeature()
返回当前地图下所有物标类型是否可选择的对应关系。

返回:
当前地图下所有物标类型是否可选择的对应关系。

setSelectableFeature

public void setSelectableFeature(java.util.Map<java.lang.String,java.lang.Boolean> value)
设置当前地图下所有物标类型是否可选择的对应关系。

设置物标是否可选择的对应关系时,需要先获得原来物标类型是否可选择的对应关系。

参数:
value - 当前地图下所有物标类型是否可选择的对应关系。

isTextClipRegionEnabled

public boolean isTextClipRegionEnabled()
返回是否启用海图图层的文本显示裁剪区。

返回:
一个布尔值,该值指示是否启用海图图层的文本显示裁剪区,true 表示启用,false表示不启用。
默认值:
默认值为 false。

setTextClipRegionEnabled

public void setTextClipRegionEnabled(boolean value)
设置是否启用海图图层的文本显示裁剪区。

参数:
value - 一个布尔值,该值指示是否启用海图图层的文本显示裁剪区,true 表示启用,false表示不启用。

isDisplayLowAccurateMarker

public boolean isDisplayLowAccurateMarker()
返回是否显示低精度符号。

返回:
一个布尔值,指示是否显示低精度符号。返回 true 表示显示低精度符号,false 表示不显示。
从以下版本开始:
SuperMap iObjects Java 7.0.0

setDisplayLowAccurateMarker

public void setDisplayLowAccurateMarker(boolean value)
设置是否显示低精度符号。

测量的海图数据使用一个 QUAPOS 属性记录数据的精度或可信度。当物标对象的的 QUAPOS 属性值为 2、3、4、5、6 、7 、8、9 中的一个时,表示该物标对象的测量是低精度的,在显示对象本身的符号的同时可能显示一个名为 LOWACC01 的符号,该符号称为“低精度符号”。注意,这里说“可能会显示低精度符号”,是因为低精度符号的显示与若干因素有关,具体的显示规则由S-52标准规定。因此,物标对象的 QUAPOS 属性值为上述值之一,是显示低精度符号的必要条件,但不是充分条件。

下图展示了符号 LOWACC01 及其在海图上的显示效果。

参数:
value - 一个布尔值,指示是否显示低精度符号。设置为 true 表示显示低精度符号,false 表示不显示。
从以下版本开始:
SuperMap iObjects Java 7.0.0