com.supermap.data
类 GeoMapGrid

java.lang.Object
  继承者 com.supermap.data.Geometry
      继承者 com.supermap.data.GeoMapGrid

public class GeoMapGrid
extends Geometry

GeoMapGrid 类,用来为布局中的地图对象添加经纬网格或者公里网,或者添加自定义的参考网格。 如下图所示,为一个布局控件,其中显示了一个布局,布局中的地图(地图为经纬度坐标系)添加了经纬网格,以及对经纬网格所指示的经纬度进行标注显示。

示例:
以下代码示范了如何为布局中的地图添加经纬网。下列代码要求已经创建了一个 Workspace实例,实例的名称(name)为:workspace,并且通过该实例打开了示范数据提供的 World.smwu 工作空间。还要求创建一个 MapLayoutControl实例,实例的名称(name)为:m_mapLayoutControl,,并且已经建立了 m_mapLayoutControl 实例与 workspace 实例的关联关系。
        public static void geoMapGridExample(Workspace workspace)
    {
                // 新建一个布局对象,并将布局对象关联到已经打开的工作空间。
        MapLayout mapLayout = m_mapLayoutControl.getMapLayout();
        mapLayout.getPaper().setOrientation(PaperOrientation.LANDSCAPE);

        // 设置布局中所显示的地图对象的范围。
        Rectangle2D bounds = mapLayout.getBounds();
        int nDis = 300;
        bounds.setLeft(bounds.getLeft() + nDis);
        bounds.setBottom(bounds.getBottom() + nDis);
        bounds.setRight(bounds.getRight() - nDis);
        bounds.setTop(bounds.getTop() - nDis);
        GeoRectangle geomapShape = new GeoRectangle(bounds, 0);
        String strMapName = "Map";
        m_geomap = new GeoMap(strMapName, geomapShape);
        m_geomap.setMapName("世界地图_Day");

        // 新建一个 GeoMapGrid 对象。
        GeoMapGrid geoMapGrid = new GeoMapGrid();

        // 设置 GeoMapGrid 对象的相关属性,即设置地图的经纬网的风格。

        // 设置为地图添加经纬网。
        geoMapGrid.setGridType(GeoMapGridType.GRATICULE);
        // 设置经纬网的格网线的线型风格。
        geoMapGrid.getGridLineStyle().setLineSymbolID(9);
        geoMapGrid.getGridLineStyle().setLineColor(Color.BLACK);
        // 设置经纬网的格网线的水平、竖直间距。
        geoMapGrid.setHorizontalGridDistance(40);
        geoMapGrid.setVerticalGridDistance(40);
        // 设置经纬网的格网线的类型为实线。
        geoMapGrid.setGridLineType(GeoMapGridLineType.SOLIDLINE);
        // 设置经纬网的边框风格。
        GeoStyle style = new GeoStyle();
        style.setLineSymbolID(6);
        style.setLineColor(Color.BLACK);
        style.setLineWidth(0.2);
        geoMapGrid.setBorderLineStyle(style);
        // 设置经纬网文本标注的水平、竖直位置。
        geoMapGrid.setHorizontalTextPosition(HorizontalTextPositionType.MIDDLE);
        geoMapGrid.setVerticalTextPosition(VerticalTextPositionType.MIDDLE);
        // 设置经纬网文本标注的文本风格。
        geoMapGrid.getGridLineTextStyle().setForeColor(Color.BLACK);
        geoMapGrid.getGridLineTextStyle().setFontHeight(60);

        // 为地图对象添加经纬网。
        m_geomap.setGridVisible(true);
        m_geomap.setMapGrid(geoMapGrid);

        // 将添加经纬网的地图对象添加到布局中。
        mapLayout.getElements().addNew(m_geomap);
        mapLayout.zoomToPaper();
        mapLayout.refresh();
    }

 

构造方法摘要
GeoMapGrid()
          构造一个新的 GeoMapGrid 对象。
GeoMapGrid(GeoMapGrid geoMapGrid)
          根据给定的 GeoMapGrid 对象构造一个与其完全相同的新对象。
 
方法摘要
 GeoMapGrid clone()
           
 void dispose()
          释放 GeoMapGrid 对象占用的资源。
 boolean fromXML(java.lang.String xml)
          此类不支持该接口。
 GeoStyle getBorderLineStyle()
          返回为地图添加的经纬网或者公里网的边框样式。
 GeoStyle getGridLineStyle()
          返回为地图添加的经纬网或者公里网的格网线的线型风格。
 TextStyle getGridLineTextStyle()
          返回经纬网或者公里网文本标注的文本风格。
 GeoMapGridLineType getGridLineType()
          返回为地图添加的经纬网或者公里网的格网线的类型。
 GeoMapGridType getGridType()
          返回为地图添加的网格的类型。
 double getHorizontalGridDistance()
          返回为地图添加的经纬网或者公里网的格网线的水平刻度值间隔。
 HorizontalTextPositionType getHorizontalTextPosition()
          返回经纬网或者公里网文本标注的水平位置。
 GeoStyle getMajorDivisionTicksStyle()
          返回经纬网或者公里网的主分割线的线型风格。
 double getMinorDivisionTicksCount()
          返回公里网的次分割线的个数。
 GeoStyle getMinorDivisionTicksStyle()
          返回公里网的次分割线的线型风格。
 GeoStyle getStyle()
          此类不支持该接口。
 double getVerticalGridDistance()
          返回为地图添加的经纬网或者公里网的格网线的垂直刻度值间隔。
 VerticalTextPositionType getVerticalTextPosition()
          返回经纬网或者公里网文本标注的垂直位置。
 boolean isEmpty()
          此类不支持该接口。
 boolean isMajorDivisionTicksVisible()
          返回是否显示经纬网或者公里网的主分割线。
 boolean isMinorDivisionTicksVisible()
          返回是否显示公里网的次分割线。
 Geometry mirror(Point2D startPoint, Point2D endPoint)
          此类不支持该接口。
 void setBorderLineStyle(GeoStyle lineStyle)
          设置为地图添加的经纬网或者公里网的边框样式。
 void setEmpty()
          此类不支持该接口。
 void setGridLineStyle(GeoStyle lineStyle)
          设置为地图添加的经纬网或者公里网的格网线的线型风格。
 void setGridLineTextStyle(TextStyle textStyle)
          设置经纬网或者公里网文本标注的文本风格。
 void setGridLineType(GeoMapGridLineType gridLineType)
          设置为地图添加的经纬网或者公里网的格网线的类型,如,可以选择不添加格网线;也可以选择不添加格网线,但是在垂直网格线和水平网格线间的交叉处添加十字丝;或者选择添加实线类型的格网线,然后自定义格网线的线型风格。
 void setGridType(GeoMapGridType gridType)
          设置为地图添加的网格的类型,如,如果地图是经纬度坐标系,可以为地图添加经纬网,如果地图是平面坐标系,可以为地图添加公里网,还可以通过自定义的方式为地图添加自定义参考网格。
 void setHorizontalGridDistance(double value)
          设置为地图添加的经纬网或者公里网的格网线的水平刻度值间隔。
 void setHorizontalTextPosition(HorizontalTextPositionType positionType)
          设置经纬网或者公里网文本标注的水平位置。
 void setMajorDivisionTicksStyle(GeoStyle geoStyle)
          设置经纬网或者公里网的主分割线的线型风格。
 void setMajorDivisionTicksVisible(boolean value)
          设置是否显示经纬网或者公里网的主分割线。
 void setMinorDivisionTicksCount(int value)
          设置公里网的次分割线的个数。
 void setMinorDivisionTicksStyle(GeoStyle geoStyle)
          设置公里网的次分割线的线型风格。
 void setMinorDivisionTicksVisible(boolean value)
          设置是否显示公里网的次分割线。
 void setStyle(GeoStyle value)
          此类不支持该接口。
 void setVerticalGridDistance(double value)
          设置为地图添加的经纬网或者公里网的格网线的垂直刻度值间隔。
 void setVerticalTextPosition(VerticalTextPositionType positionType)
          设置经纬网或者公里网文本标注的垂直位置。
 java.lang.String toXML()
          此类不支持该接口。
 
从类 com.supermap.data.Geometry 继承的方法
addCustomGeometryCreatedListener, getBounds, getID, getInnerPoint, getType, getVariantID, hitTest, offset, removeCustomGeometryCreatedListener, resize, rotate, setID
 
从类 java.lang.Object 继承的方法
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

构造方法详细信息

GeoMapGrid

public GeoMapGrid()
构造一个新的 GeoMapGrid 对象。


GeoMapGrid

public GeoMapGrid(GeoMapGrid geoMapGrid)
根据给定的 GeoMapGrid 对象构造一个与其完全相同的新对象。

参数:
geoMapGrid - 一个 GeoMapGrid 对象。
方法详细信息

getGridType

public GeoMapGridType getGridType()
返回为地图添加的网格的类型。

返回:
返回为地图添加的网格的类型。

setGridType

public void setGridType(GeoMapGridType gridType)
设置为地图添加的网格的类型,如,如果地图是经纬度坐标系,可以为地图添加经纬网,如果地图是平面坐标系,可以为地图添加公里网,还可以通过自定义的方式为地图添加自定义参考网格。

参数:
gridType - 一个枚举值,用来设置为地图添加的网格的类型。

getVerticalGridDistance

public double getVerticalGridDistance()
返回为地图添加的经纬网或者公里网的格网线的垂直刻度值间隔。如果为经纬网,单位为度;如果为公里网,单位为千米。

返回:
返回为地图添加的经纬网或者公里网的格网线的垂直刻度值间隔。如果为经纬网,单位为度;如果为公里网,单位为千米。

setVerticalGridDistance

public void setVerticalGridDistance(double value)
设置为地图添加的经纬网或者公里网的格网线的垂直刻度值间隔。如果为经纬网,单位为度;如果为公里网,单位为千米。

参数:
value - 垂直刻度值间隔。如果为经纬网,单位为度;如果为公里网,单位为千米。

getHorizontalGridDistance

public double getHorizontalGridDistance()
返回为地图添加的经纬网或者公里网的格网线的水平刻度值间隔。如果为经纬网,单位为度;如果为公里网,单位为千米。

返回:
返回为地图添加的经纬网或者公里网的格网线的水平刻度值间隔。如果为经纬网,单位为度;如果为公里网,单位为千米。

setHorizontalGridDistance

public void setHorizontalGridDistance(double value)
设置为地图添加的经纬网或者公里网的格网线的水平刻度值间隔。如果为经纬网,单位为度;如果为公里网,单位为千米。

参数:
value - 水平刻度值间隔。如果为经纬网,单位为度;如果为公里网,单位为千米。

getGridLineStyle

public GeoStyle getGridLineStyle()
返回为地图添加的经纬网或者公里网的格网线的线型风格。

返回:
返回为地图添加的经纬网或者公里网的格网线的线型风格。

setGridLineStyle

public void setGridLineStyle(GeoStyle lineStyle)
设置为地图添加的经纬网或者公里网的格网线的线型风格。只有在设置的格网线的类型为实线类型时,该属性的设置才生效。

参数:
lineStyle - 为地图添加的经纬网或者公里网的格网线的线型风格。

getBorderLineStyle

public GeoStyle getBorderLineStyle()
返回为地图添加的经纬网或者公里网的边框样式。

返回:
返回为地图添加的经纬网或者公里网的边框样式。

setBorderLineStyle

public void setBorderLineStyle(GeoStyle lineStyle)
设置为地图添加的经纬网或者公里网的边框样式。

参数:
lineStyle - 一个 GeoStyle 对象,为地图添加的经纬网或者公里网的边框样式边框样式。

getGridLineType

public GeoMapGridLineType getGridLineType()
返回为地图添加的经纬网或者公里网的格网线的类型。

返回:
返回为地图添加的经纬网或者公里网的格网线的类型。

setGridLineType

public void setGridLineType(GeoMapGridLineType gridLineType)
设置为地图添加的经纬网或者公里网的格网线的类型,如,可以选择不添加格网线;也可以选择不添加格网线,但是在垂直网格线和水平网格线间的交叉处添加十字丝;或者选择添加实线类型的格网线,然后自定义格网线的线型风格。

参数:
gridLineType - 一个枚举值,指定为地图添加的经纬网或者公里网的格网线的类型。

isMajorDivisionTicksVisible

public boolean isMajorDivisionTicksVisible()
返回是否显示经纬网或者公里网的主分割线。

返回:
返回是否显示经纬网或者公里网的主分割线。True,表示显示;false,表示不显示。

setMajorDivisionTicksVisible

public void setMajorDivisionTicksVisible(boolean value)
设置是否显示经纬网或者公里网的主分割线。

参数:
value - 一个布尔值,指定是否显示经纬网或者公里网的主分割线。True,表示显示;false,表示不显示。

getMajorDivisionTicksStyle

public GeoStyle getMajorDivisionTicksStyle()
返回经纬网或者公里网的主分割线的线型风格。

返回:
返回经纬网或者公里网的主分割线的线型风格。

setMajorDivisionTicksStyle

public void setMajorDivisionTicksStyle(GeoStyle geoStyle)
设置经纬网或者公里网的主分割线的线型风格。

参数:
geoStyle - 一个 GeoStyle 对象,指定经纬网或者公里网的主分割线的线型风格。

isMinorDivisionTicksVisible

public boolean isMinorDivisionTicksVisible()
返回是否显示公里网的次分割线。

返回:
返回是否显示公里网的次分割线。True,表示显示;false,表示不显示。

setMinorDivisionTicksVisible

public void setMinorDivisionTicksVisible(boolean value)
设置是否显示公里网的次分割线。

参数:
value - 一个布尔值,指定是否显示经纬网或者公里网的次分割线。True,表示显示;false,表示不显示。

getMinorDivisionTicksStyle

public GeoStyle getMinorDivisionTicksStyle()
返回公里网的次分割线的线型风格。

返回:
返回公里网的次分割线的线型风格。

setMinorDivisionTicksStyle

public void setMinorDivisionTicksStyle(GeoStyle geoStyle)
设置公里网的次分割线的线型风格。

参数:
geoStyle - 一个 GeoStyle 对象,指定经纬网或者公里网的次分割线的线型风格。

getMinorDivisionTicksCount

public double getMinorDivisionTicksCount()
返回公里网的次分割线的个数。

返回:
返回公里网的次分割线的个数。

setMinorDivisionTicksCount

public void setMinorDivisionTicksCount(int value)
设置公里网的次分割线的个数。

参数:
value - 公里网的次分割线的个数。

getHorizontalTextPosition

public HorizontalTextPositionType getHorizontalTextPosition()
返回经纬网或者公里网文本标注的水平位置。

返回:
返回经纬网或者公里网文本标注的水平位置。

setHorizontalTextPosition

public void setHorizontalTextPosition(HorizontalTextPositionType positionType)
设置经纬网或者公里网文本标注的水平位置。

参数:
positionType - 一个枚举值,指定经纬网或者公里网文本标注的水平位置。

getVerticalTextPosition

public VerticalTextPositionType getVerticalTextPosition()
返回经纬网或者公里网文本标注的垂直位置。

返回:
返回经纬网或者公里网文本标注的垂直位置。

setVerticalTextPosition

public void setVerticalTextPosition(VerticalTextPositionType positionType)
设置经纬网或者公里网文本标注的垂直位置。

参数:
positionType - 一个枚举值,指定经纬网或者公里网文本标注的垂直位置。

getGridLineTextStyle

public TextStyle getGridLineTextStyle()
返回经纬网或者公里网文本标注的文本风格。

返回:
返回经纬网或者公里网文本标注的文本风格。

setGridLineTextStyle

public void setGridLineTextStyle(TextStyle textStyle)
设置经纬网或者公里网文本标注的文本风格。

参数:
textStyle - 一个 TextStyle 对象,指定经纬网或者公里网文本标注的文本风格。

clone

public GeoMapGrid clone()
覆盖:
java.lang.Object 中的 clone

dispose

public void dispose()
释放 GeoMapGrid 对象占用的资源。

覆盖:
Geometry 中的 dispose

fromXML

public boolean fromXML(java.lang.String xml)
此类不支持该接口。

覆盖:
Geometry 中的 fromXML
参数:
xml - XML 格式的字符串。
返回:
如果构造成功返回 true,否则返回 false。
另请参见:
Geometry.offset(double, double)

toXML

public java.lang.String toXML()
此类不支持该接口。

覆盖:
Geometry 中的 toXML
返回:
表示几何对象的 XML 字符串。
另请参见:
Geometry.offset(double, double)

setEmpty

public void setEmpty()
此类不支持该接口。

覆盖:
Geometry 中的 setEmpty

isEmpty

public boolean isEmpty()
此类不支持该接口。

覆盖:
Geometry 中的 isEmpty
返回:
一个布尔值指定几何对象是否为空。
另请参见:
Geometry.offset(double, double)

getStyle

public GeoStyle getStyle()
此类不支持该接口。

覆盖:
Geometry 中的 getStyle
返回:
几何对象的风格。

setStyle

public void setStyle(GeoStyle value)
此类不支持该接口。

覆盖:
Geometry 中的 setStyle
参数:
value - 用来设置几何对象风格的 GeoStyle 对象。
另请参见:
Geometry.offset(double, double)

mirror

public Geometry mirror(Point2D startPoint,
                       Point2D endPoint)
此类不支持该接口。

覆盖:
Geometry 中的 mirror
参数:
startPoint - 线段的起点。
endPoint - 线段的终点。
返回:
该几何对象关于指定对称的几何对象。
另请参见:
Geometry.offset(double,double)