com.supermap.ui

类 MapControl

  • 所有已实现的接口:
    IDisposable, ImageObserver, MenuContainer, Serializable, Runnable


    public class MapControl
    extends JComponent
    implements Serializable, IDisposable, Runnable
    地图控件类。

    该类是用于为地图的显示提供界面的,同时为地图与数据的互操作提供了途径。

    地图控件是一个对地图进行显示的控件。通过地图控件,不仅可以对地图进行显示,而且可以通过对地图的可视化编辑,从而对地图所引用的数据进行编辑。当一个地图对象与一个地图控件相关联,该地图控件即可以对该地图对象进行显示,地图的显示属性以及显示操作都将在该地图对象中设置。然而对地图的可视化编辑的设置和操作将在 MapControl 对象中设置。其中,对于地图的浏览的操作,如缩放和平移等,在 Map 对象和 MapControl 中都可以进行,所不同的是在 Map 对象中的地图操作是让地图在无界面显示时也可以对地图进行浏览,而且只提供对地图的简单的平移和指定比例地缩放;而通过 MapControl.get/setAction() 方法提供更多的缩放和平移功能,并且提供各种选择方式,如点选,圆选,框选等等。

    该类提供了各种对地图及其图层进行编辑的方法,如一个图层中或跨图层的对象的拷贝、剪切、粘贴等,以及对象的绘制,编辑以及删除等。当然,当前编辑图层必须被设置为可编辑状态。另外,该类还提供了对地图中某点的地图坐标和像素坐标之间的转换的方法。

    地图窗口中提供了如下表所示的鼠标键盘操作来实现相应的功能。

    当地图控件中的操作状态为选择对象时,可以选中可选择图层中的对象,并支持多选;但是,如果可选择图层对应的数据集为 CAD 数据集,并且,其中包含了复合几何对象(GeoCompound 对象),在选择时,不支持选中同一个复合几何对象中的多个子对象。

    注意:当用户使用该工作空间对象进行编程时,如果将 Workspace 与 MapControl 建立了关联,那么在进行对象的关闭时,一定需要注意关闭的顺序,如下:

    1. 关闭 Map 对象;
    2. 关闭 MapControl 对象;
    3. 关闭 Workspace 对象。
    另请参阅:
    序列化表格
    • 构造器详细资料

      • MapControl

        public MapControl()
        默认构造函数,构造一个新的 MapControl 对象。
      • MapControl

        public MapControl(Workspace workspace)
        构造一个新的 MapControl 对象,并将其中的 Map 对象关联到指定的工作空间。
        参数:
        workspace - 指定的工作空间。
    • 方法详细资料

      • setCancelMapDrawingByEscKey

        public static void setCancelMapDrawingByEscKey(boolean value)
        设置是否使用键盘ESC键取消地图绘制。默认为true。
        参数:
        value - 是否使用键盘ESC键取消地图绘制
      • isCancelMapDrawingByEscKey

        public static boolean isCancelMapDrawingByEscKey()
        获取是否使用键盘ESC键取消地图绘制。
        返回:
        是否使用键盘ESC键取消地图绘制。默认为true。
      • getSnapSetting

        public SnapSetting getSnapSetting()
        返回地图控件的捕捉设置类对象。当在地图窗口中进行编辑时,为了提高编辑的精度和效率,可以使用相应的捕捉模式(请参见 SnapMode 类)。通过该方法可以返回相关的捕捉控制参数,包括捕捉时光标定位点的容限、最多可以捕捉的对象数、捕捉线的最小长度以及控制哪些捕捉模式有效等等,详细信息请参见 SnapSetting 类。
        返回:
        返回地图控件的捕捉设置类对象。
        默认值:
        默认值为 {FixedAngle=90,FixedLength=1000,IsSnappedLineBroken=False,MaxSnappedCount=500,MinSnappedLength=50,Tolerance=3,EnableSnapModes=PointOnEndpointPointOnPointPointOnLinePointOnExtensionPointWithHorizontalOrVerticalLineWithFixedAngleLineWithHorizontalOrVerticalLineWithPerpendicularLineWithParallelLineWithFixedLength}。
      • setSnapSetting

        public void setSnapSetting(SnapSetting value)
        设置地图控件的捕捉设置类对象。当在地图窗口中进行编辑时,为了提高编辑的精度和效率,可以使用相应的捕捉模式(请参见 SnapMode 类)。通过该方法可以设置相关的捕捉控制参数,包括捕捉时光标定位点的容限、最多可以捕捉的对象数、捕捉线的最小长度以及控制哪些捕捉模式有效等等,详细信息请参见 SnapSetting 类。
        参数:
        value - 地图控件的捕捉设置类对象。
      • getTrackMode

        public TrackMode getTrackMode()
        返回绘制方式,即在地图控件中绘制对象时,是在图层中创建一个新对象还是在内存中创建一个新对象,或者是在 CAD 图层中绘制地图几何对象(GeoMap)。
        返回:
        返回绘制方式。
        默认值:
        默认值为 TrackMode.EDIT
      • setTrackMode

        public void setTrackMode(TrackMode value)
        设置绘制方式,即在地图控件中绘制对象时,是在图层中创建一个新对象还是在内存中创建一个新对象,或者是在 CAD 图层中绘制地图几何对象(GeoMap)。
        参数:
        value - 绘制方式。
      • getSnappedElements

        public SnappedElement[] getSnappedElements()
        返回当前地图窗口中被捕捉的对象的集合。
        返回:
        返回被捕捉的对象的集合。
      • getEditableLayers

        public Layer[] getEditableLayers()
        返回地图的可编辑图层。
        返回:
        返回存储地图可编辑图层的数组。
      • getAssistantRegionStyle

        public GeoStyle getAssistantRegionStyle()
        返回绘制对象时辅助区域的风格。在框选,圆选,自由区域选择,拉框放大等操作时会出现该辅助区域。
        返回:
        返回绘制对象时辅助区域的风格。
        默认值:
        默认值为 {FillBackColor=Color [A=255, R=255, G=255, B=255],FillForeColor=Color [A=255, R=189, G=235, B=255],FillGradientAngle=0,FillGradientMode=None,FillGradientOffsetRatioX=0,FillGradientOffsetRatioY=0,FillOpaqueRate=100,FillSymbolID=1,LineColor=Color [A=255, R=50, G=50, B=50],LineSymbolID=2,LineWidth=0.1,MarkerAngle=0,MarkerSize={Width=2.4,Height=-1},MarkerSymbolID=0}。
      • setAssistantRegionStyle

        public void setAssistantRegionStyle(GeoStyle value)
        设置绘制对象时辅助区域的风格。在框选,圆选,自由区域选择,拉框放大等操作时会出现该辅助区域。
        参数:
        value - 绘制对象时辅助区域的风格。
      • canRedo

        public boolean canRedo()
        返回当前地图窗口是否可以进行恢复操作。
        返回:
        返回当前地图窗口是否可以进行恢复操作。
        默认值:
        默认值为 false。
      • canUndo

        public boolean canUndo()
        返回当前地图窗口是否可以进行取消当前编辑内容的操作。
        返回:
        返回当前地图窗口是否可以进行取消当前编辑内容的操作。
        默认值:
        默认值为 false。
      • canCut

        public boolean canCut()
        返回当前地图窗口是否可以进行剪切操作。
        返回:
        返回当前地图窗口是否可以进行剪切操作。
        默认值:
        默认值为 false。
      • canCopy

        public boolean canCopy()
        返回当前地图窗口是否可以进行复制操作。
        返回:
        返回当前地图窗口是否可以进行复制操作。
        默认值:
        默认值为 false。
      • canPaste

        public boolean canPaste()
        返回当前地图窗口是否可以进行粘贴操作。
        返回:
        返回当前地图窗口是否可以进行粘贴操作。
        默认值:
        默认值为 false。
      • getActiveEditableLayer

        public Layer getActiveEditableLayer()
        返回当前的可编辑图层。

        如果当前是多图层编辑模式(即 setMultiLayerEditable() 方法设置为 true),则当前可编辑图层的默认值为可编辑图层的第一个图层,对对象的绘制和粘贴操作只作用在该图层上,而非所有的可编辑图层上。

        返回:
        返回当前的可编辑图层。
        默认值:
        默认值为空。
      • setActiveEditableLayer

        public void setActiveEditableLayer(Layer value)
        设置当前的可编辑图层。

        如果当前是多图层编辑模式(即 setMultiLayerEditable() 方法设置为 true),则当前可编辑图层的默认值为可编辑图层的第一个图层,对对象的绘制和粘贴操作只作用在该图层上,而非所有的可编辑图层上。

        参数:
        value - 当前的可编辑图层。
      • isMultiLayerEditEnabled

        public boolean isMultiLayerEditEnabled()
        返回当前是否可以使用多图层编辑模式。
        返回:
        返回当前是否可以使用多图层编辑模式。
        默认值:
        默认值为 false。
      • setMultiLayerEditEnabled

        public void setMultiLayerEditEnabled(boolean value)
        设置当前是否可以使用多图层编辑模式。
        参数:
        value - 一个布尔值指定当前是否可以使用多图层编辑模式。
      • isGlobalBrowsing

        public boolean isGlobalBrowsing()
        获取地图窗口是否全球连贯漫游模式。

        全球连贯漫游是指浏览世界地图时显示为东西半球无缝漫游,实现了在平面上浏览世界范围的地图跟在球体上浏览地图的相同体验。开启全球连贯漫游之后,所显示的世界地图范围的起止经度不限制在-180到+180经度范围,随着鼠标的平移起止范围发生变化。

        返回:
        地图窗口是否全球连贯漫游模式
      • setGlobalBrowsing

        public void setGlobalBrowsing(boolean value)
        设置地图窗口是否全球连贯漫游模式。

        全球连贯漫游是指浏览世界地图时显示为东西半球无缝漫游,实现了在平面上浏览世界范围的地图跟在球体上浏览地图的相同体验。开启全球连贯漫游之后,所显示的世界地图范围的起止经度不限制在-180到+180经度范围,随着鼠标的平移起止范围发生变化。

        参数:
        value - 是否全球连贯漫游模式
      • setRefreshAtTracked

        public void setRefreshAtTracked(boolean value)
        设置是否支持几何对象编辑结束时地图实时刷新。

        如果设置为不支持地图实时刷新,则在几何对象编辑结束时不会刷新地图,会留下编辑痕迹;反之,则不会留下编辑痕迹,但是当地图数据比较大时会影响编辑效率。

        参数:
        value - 是否支持几何对象编辑结束时地图实时刷新。true 为支持地图实时刷新,false 为不支持地图实时刷新。
      • refreshAtTracked

        public boolean refreshAtTracked()
        返回是否支持几何对象编辑结束时地图实时刷新。

        如果设置为不支持地图实时刷新,则在几何对象编辑结束时不会刷新地图,会留下编辑痕迹;反之,则不会留下编辑痕迹,但是当地图数据比较大时会影响编辑效率。

        返回:
        一个布尔值,表示是否支持几何对象编辑结束时地图实时刷新。如果支持实时刷新,则返回 true,否则返回 false。
        默认值:
        默认值为true。支持几何对象编辑结束时地图实时刷新。
      • setViscousMove

        public void setViscousMove(int value)
        设置地图窗口对象编辑时粘滞移动容差

        编辑节点时拖动节点,节点移动距离在容差像素范围内就将此次移动取消,避免误操作。

        参数:
        value - 粘滞移动容差
      • getViscousMove

        public int getViscousMove()
        获取地图窗口对象编辑时粘滞移动容差。

        编辑节点时拖动节点,节点移动距离在容差像素范围内就将此次移动取消,避免误操作。

        返回:
        粘滞移动容差
      • setShowEditingControlPoints

        public void setShowEditingControlPoints(boolean value)
        设置是否在绘制时显示控制点(节点)
        参数:
        value - 是否在绘制时显示控制点
        抛出:
        IllegalStateException - 当前对象已被释放
        从以下版本开始:
        11.2
      • isShowEditingControlPoints

        public boolean isShowEditingControlPoints()
        获取是否在绘制时显示控制点(节点)
        返回:
        是否在绘制时显示控制点
        抛出:
        IllegalStateException - 当前对象已被释放
        从以下版本开始:
        11.2
      • setRefreshInInvalidArea

        public void setRefreshInInvalidArea(boolean value)
        设置是否平移地图时仅刷新局部改变区域。
        参数:
        value - 是否支持平移地图时仅刷新局部改变区域。true 为支持平移地图时仅刷新局部改变区域,false 为不支持平移地图时仅刷新局部改变区域。
      • refreshInInvalidArea

        public boolean refreshInInvalidArea()
        返回是否支持平移地图时仅刷新局部改变区域。
        返回:
        一个布尔值,表示是否支持平移地图时仅刷新局部改变区域。如果支持平移地图时仅刷新局部改变区域,则返回true,否则返回false。
        默认值:
        默认值为false。不支持平移地图时仅刷新局部改变区域。
      • getVectorizationSetting

        public VectorizationSetting getVectorizationSetting()
        返回交互式自动跟踪选项设置类对象,当在地图窗口中进行交互式自动跟踪矢量化,该方法用于返回跟踪矢量化之前或跟踪矢量化过程中的交互式跟踪参数设置,包括曲线光滑参数、颜色容限值等参数,详细信息请参见 VectorizationSetting 类。
        返回:
        返回交互式自动跟踪选项设置类对象。
        默认值:
        默认值为 {AutoPan=True,BackgroundColor=Color [A=255, R=255, G=255, B=255],ColorTolerance=32,Filter=0.7,RasterLayer=Null,Smoothness=2}
      • setVectorizationSetting

        public void setVectorizationSetting(VectorizationSetting value)
        设置交互式自动跟踪选项设置类对象,当在地图窗口中进行交互式自动跟踪矢量化,该方法用于对跟踪矢量化之前或跟踪矢量化过程中的交互式跟踪参数进行设置,包括曲线光滑参数、颜色容限值等参数,详细信息请参见 VectorizationSetting 类。
        参数:
        value - 交互式自动跟踪选项设置类对象。
      • getAction

        public Action getAction()
        返回地图控件中地图的当前操作状态。在 Action 类中定义了目前支持的所有的对地图的操作模式。
        返回:
        地图控件中地图的当前操作状态。
        抛出:
        EnumConstantNotPresentException - 当取出的值错误时。
        默认值:
        默认值为 Action.SELECT2,即点击选择对象,如果按住鼠标拖拽,就变成利用鼠标框选对象。
      • setAction

        public void setAction(Action action)
        设置地图控件中地图的当前操作状态。在 Action 类中定义了目前支持的所有的对地图的操作模式。
        参数:
        action - 指定地图控件中地图的当前操作状态。
        示范代码:
        以下代码示例了 setAction() 方法的应用,假定已经定义了一个名为 mapControl1 的 MapControl 控件实例。
             //设置对地图进行放大的操作
             public void jButtonZoomIn_actionPerformed(ActionEvent e)
             {
                 mapControl1.setAction(Action.ZOOMIN);
             }
             //设置对地图进行缩小的操作
             public void jButtonZoomOut_actionPerformed(ActionEvent e)
             {
                 mapControl1.setAction(Action.ZOOMOUT);
             }
             //设置对地图进行自由缩放的操作
             public void jButtonZoomFree_actionPerformed(ActionEvent e)
             {
                 mapControl1.setAction(Action.ZOOMFREE);
             }
        
             //设置对地图进行漫游的操作
             public void jButtonPan_actionPerformed(ActionEvent e)
             {
                 mapControl1.setAction(Action.PAN);
             }
        
             //设置对地图进行框选的操作
             public void jButtonSelect_actionPerformed(ActionEvent e)
             {
                 mapControl1.setAction(Action.SELECT);
             }
      • getMarginPanEnabled

        public boolean getMarginPanEnabled()
        返回此地图控件的自动滚屏功能的开关状态。自动滚屏功能打开时,为 true;关闭时为 false。地图控件的自动滚屏功能打开时,当鼠标指针靠近地图控件显示边界时,点击鼠标后显示区域就会根据指定的方向滚动指定的距离,如图所示,滚屏可以在8个方向进行,例如,当鼠标靠近上边线被点击,显示区域将向上滚动指定的距离来显示原显示范围上方区域的地图内容。滚动的距离是由 getMarginPanPercent()setMarginPanPercent() 方法来指定的。

        返回:
        地图控件的自动滚屏功能的开关状态。
        默认值:
        默认值为 true,即默认自动滚屏功能打开。
      • setMarginPanEnabled

        public void setMarginPanEnabled(boolean value)
        设置此地图控件的自动滚屏功能的开关状态。自动滚屏功能打开时,为 true;关闭时为 false。地图控件的自动滚屏功能打开时,当鼠标指针靠近地图控件显示边界时,点击鼠标后显示区域就会根据指定的方向滚动指定的距离,如图所示,滚屏可以在8个方向进行,例如,当鼠标靠近上边线被点击,显示区域将向上滚动指定的距离来显示原显示范围上方区域的地图内容。滚动的距离是由 getMarginPanPercent()setMarginPanPercent() 方法来指定的。

        参数:
        value - 指定地图控件的自动滚屏功能的开关状态。
      • getMarginPanPercent

        public double getMarginPanPercent()
        返回自动滚屏的比例。自动滚屏的比例是滚动的范围与地图控件显示范围的比例,例如,当自动滚屏的比例设置为 0.5 时,显示区域将在地图上平移半个显示区域的范围。当鼠标在显示区域的四个边角中的其中一处点击时,例如在左上角处,若自动滚屏的比例设置为 0.5 ,则在显示区域将向上滚动半个显示范围的高度和向左滚动半个显示范围的宽度的距离。

        返回:
        自动滚屏的比例。
        默认值:
        默认自动滚屏的比例为 50%。
      • setMarginPanPercent

        public void setMarginPanPercent(double value)
        设置自动滚屏的比例。自动滚屏的比例是滚动的范围与地图控件显示范围的比例,例如,当自动滚屏的比例设置为 0.5 时,显示区域将在地图上平移半个显示区域的范围。当鼠标在显示区域的四个边角中的其中一处点击时,例如在左上角处,若自动滚屏的比例设置为 0.5 ,则在显示区域将向上滚动半个显示范围的高度和向左滚动半个显示范围的宽度的距离。

        参数:
        value - 指定自动滚屏的比例。
      • getSelectionTolerance

        public double getSelectionTolerance()
        返回选择空间对象的容限。即要素上距离鼠标指针最近点到鼠标指针的距离在的多大范围以内,可以认为该空间对象被选中,单位为毫米,精确到 0.1 毫米。针对点选方式。
        返回:
        选择空间对象的容限。
        默认值:
        默认值为 1。
      • setSelectionTolerance

        public void setSelectionTolerance(double value)
        设置选择空间对象的容限。即要素上距离鼠标指针最近点到鼠标指针的距离在的多大范围以内,可以认为该空间对象被选中,单位为毫米,精确到 0.1 毫米。针对点选方式。
        参数:
        value - 指定选择空间对象的容限。
      • getSelectionMode

        public SelectionMode getSelectionMode()
        返回对象的选择模式。参见 SelectionMode 常量。针对除点选之外的区域选择方式。
        返回:
        对象的选择模式。
        默认值:
        默认的对象选择模式为 SelectionMode.CONTAIN_INNER_POINT,即对象的内点在选择范围内的就选中。
      • setInvertSelectionMode

        public void setInvertSelectionMode(SelectionMode selectionMode)
        设置地图窗口反向选择对象的选择模式。
        参数:
        selectionMode - 地图窗口反向选择对象的选择模式。
      • getInvertSelectionMode

        public SelectionMode getInvertSelectionMode()
        返回地图窗口反向选择对象的选择模式。
        返回:
        地图窗口反向选择对象的选择模式。
      • setSelectionMode

        public void setSelectionMode(SelectionMode selectionMode)
        设置对象的选择模式。参见 SelectionMode 常量。针对除点选之外的区域选择方式。
        参数:
        selectionMode - 指定对象的选择模式。
      • getSelectionPixelTolerance

        public int getSelectionPixelTolerance()
        返回选择空间对象的容限。即要素上距离鼠标指针最近点到鼠标指针的距离在多大范围以内,可以认为该空间对象被选中,单位为像素。针对点选方式。
        返回:
        返回选择空间对象的容限。
        默认值:
        默认值为 1。
      • setSelectionPixelTolerance

        public void setSelectionPixelTolerance(int value)
        设置选择空间对象的容限。即要素上距离鼠标指针最近点到鼠标指针的距离在多大范围以内,可以认为该空间对象被选中,单位为像素。针对点选方式。
        参数:
        value - 选择空间对象的容限。
      • getMaxEditGeometriesCount

        public long getMaxEditGeometriesCount()
        获取最大可编辑对象数
        返回:
        最大可编辑对象数
      • setMaxEditGeometriesCount

        public void setMaxEditGeometriesCount(long value)
        设置最大可编辑对象数
        参数:
        value - 最大可编辑对象数
      • isOtherThreadDraw

        @Deprecated
        public boolean isOtherThreadDraw()
        已过时。 
      • isDrawThreadRunning

        @Deprecated
        public boolean isDrawThreadRunning()
        已过时。 
      • setDrawThreadRunning

        @Deprecated
        public void setDrawThreadRunning(boolean value)
        已过时。 
      • getMap

        public Map getMap()
        返回在地图控件中显示的地图对象。
        返回:
        在地图控件中显示的地图对象。
        示范代码:
        请参见 QueryParameter 的示例。
        默认值:
        默认值为空的Map对象
      • setInteractionMode

        public void setInteractionMode(InteractionMode value)
        设置交互操作模式。通过该方法的设置,可以确定用户的键盘鼠标交互操作模式,也就是说用于响应用户操作的模式。
        参数:
        value - 交互操作模式。
      • getInteractionMode

        public InteractionMode getInteractionMode()
        返回交互操作模式。通过该方法的设置,可以确定用户的键盘鼠标交互操作模式,也就是说用于响应用户操作的模式。
        返回:
        返回交互操作模式。
        默认值:
        默认值为 InteractionMode.DEFAULT
      • getHandleOptions

        public EditHandleOptions getHandleOptions()
        返回编辑手柄的选项。编辑手柄选项可以控制相应的编辑手柄的可用状态。
        返回:
        返回编辑手柄的选项。
        默认值:
        默认值为 {TopLeft,TopCenter,TopRight,CenterLeft,CenterRight,BottomLeft,BottomCenter,BottomRight,RotationHandle,RotationBase,MoveHandle,VertexEditHandle}。
      • setHandleOptions

        public void setHandleOptions(EditHandleOptions value)
        设置编辑手柄的选项。编辑手柄选项可以控制相应的编辑手柄的可用状态。
        参数:
        value - 编辑手柄的选项。
      • getTrackingStyle

        public GeoStyle getTrackingStyle()
        返回正在绘制的对象的风格。
        返回:
        返回正在绘制的对象的风格。
        默认值:
        默认值为 {FillBackColor=Color [A=255, R=255, G=255, B=255],FillForeColor=Color [A=255, R=189, G=235, B=255],FillGradientAngle=0,FillGradientMode=None,FillGradientOffsetRatioX=0,FillGradientOffsetRatioY=0,FillOpaqueRate=100,FillSymbolID=1,LineColor=Color [A=255, R=0, G=0, B=255],LineSymbolID=0,LineWidth=0.1,MarkerAngle=0,MarkerSize={Width=2.4,Height=-1},MarkerSymbolID=0}。
      • setTrackingStyle

        public void setTrackingStyle(GeoStyle value)
        设置正在绘制的对象的风格。
        参数:
        value - 正在绘制的对象的风格。
      • getAssistantLineStyle

        public GeoStyle getAssistantLineStyle()
        返回绘制对象时辅助线的风格。在绘制 B 样条,三点圆等几何对象时会出现辅助线。
        返回:
        返回绘制对象时辅助线的风格。
        默认值:
        默认值为 {FillBackColor=Color [A=255, R=255, G=255, B=255],FillForeColor=Color [A=255, R=189, G=235, B=255],FillGradientAngle=0,FillGradientMode=None,FillGradientOffsetRatioX=0,FillGradientOffsetRatioY=0,FillOpaqueRate=100,FillSymbolID=1,LineColor=Color [A=255, R=0, G=0, B=255],LineSymbolID=2,LineWidth=0.1,MarkerAngle=0,MarkerSize={Width=2.4,Height=-1},MarkerSymbolID=0}。
      • setAssistantLineStyle

        public void setAssistantLineStyle(GeoStyle value)
        设置绘制对象时辅助线的风格。在绘制 B 样条,三点圆等几何对象时会出现辅助线。
        参数:
        value - 绘制对象时辅助线的风格。
      • aboutBox

        public void aboutBox()
        用于显示地图控件的“关于”对话框。
      • copy

        public boolean copy()
        将地图中选中的对象复制到系统的剪贴板上。
        返回:
        成功完成复制操作返回 true;否则返回 false。
      • cut

        public boolean cut()
        将地图可编辑图层中选中的对象剪切到剪贴板中。
        返回:
        成功完成剪切操作返回 true;否则返回 false。
      • delete

        public boolean delete()
        将地图中选中的对象删除。

        当选中对象内的节点时,删除所选节点。

        返回:
        删除成功返回 true,否则返回 false。
      • canDelete

        public boolean canDelete()
        返回当前地图窗口是否可以进行删除操作。
        返回:
        返回当前地图窗口是否可以进行删除操作。
      • paste

        public boolean paste()
        将剪贴板中的对象粘贴到当前地图的可编辑图层中。
        返回:
        成功完成粘贴操作返回 true;否则返回 false。
      • redo

        public boolean redo()
        地图窗口上恢复上一步的操作。恢复操作必须以撤销操作为前提。
        返回:
        成功完成恢复操作返回 true;否则返回 false。
      • undo

        public boolean undo()
        地图控件上撤消上一次的操作。
        返回:
        成功完成撤销操作返回 true;否则返回 false。
      • doMouseDown

        public void doMouseDown(MouseEvent e)
        调用该方法执行按下鼠标操作。
        参数:
        e - 指定的鼠标动作的事件。
      • doMouseMove

        public void doMouseMove(MouseEvent e)
        调用该方法执行鼠标移动操作。
        参数:
        e - 指定的鼠标动作的事件。
      • doMouseUp

        public void doMouseUp(MouseEvent e)
        调用该方法执行释放鼠标操作。
        参数:
        e - 指定的鼠标动作的事件。
      • doMouseWheel

        public void doMouseWheel(MouseWheelEvent e)
        调用该方法执行鼠标滚轮操作。
        参数:
        e - 指定的鼠标动作的事件。
      • doKeyDown

        public void doKeyDown(KeyEvent e)
        调用该方法执行按下键盘操作。
        参数:
        e - 指定的键盘操作的事件。
      • doKeyUp

        public void doKeyUp(KeyEvent e)
      • doGeometryCreate

        public boolean doGeometryCreate(Geometry geometry)
        在当前编辑图层添加一个几何对象,该对象支持撤销和重做操作。
        参数:
        geometry - 要添加的几何对象。
        返回:
        添加成功返回 true,否则返回 false。
      • dispose

        public void dispose()
        释放对象所占用的资源。调用该方法之后,此对象不再可用。
        指定者:
        dispose 在接口中 IDisposable
      • setSize

        public void setSize(int width,
                            int height)
        覆盖:
        setSize 在类中 Component
      • setBounds

        public void setBounds(int x,
                              int y,
                              int width,
                              int height)
        覆盖:
        setBounds 在类中 Component
      • getRollingWheelWithoutDelay

        public boolean getRollingWheelWithoutDelay()
        返回是否使用滚轮延迟刷新。
        返回:
        是否使用滚轮延迟刷新。
        默认值:
        默认值为false,表示使用滚轮延迟刷新。
      • setRollingWheelWithoutDelay

        public void setRollingWheelWithoutDelay(boolean value)
        设置是否使用滚轮延迟刷新。
        参数:
        value - 一个布尔值,表示是否使用滚轮延迟刷新,false,使用滚轮延迟刷新,true,不使用滚轮延迟刷新。
      • isCursorCustomized

        public boolean isCursorCustomized()
        返回自定义当前地图空间的光标变化是否有效。

        返回 true 时,控件的光标完全由用户来控制;返回 fasle 时,光标的变换由控件自己负责。

        返回:
        返回自定义当前地图空间的光标变化是否有效。
      • setCursorCustomized

        public void setCursorCustomized(boolean cursorCustomized)
        设置自定义当前地图空间的光标变化是否有效。
        参数:
        cursorCustomized - 自定义当前地图空间的光标变化是否有效。
      • isWaitCursorEnabled

        public boolean isWaitCursorEnabled()
        返回当前地图窗口的等待光标是否有效。

        返回值为 true 时,在地图绘制等待时,系统会自动切换成等待光标;为 false 时,则不会自动切换等待光标。

        返回:
        当前地图窗口的等待光标是否有效。
      • setWaitCursorEnabled

        public void setWaitCursorEnabled(boolean waitCursorEnabled)
        设置当前地图窗口的等待光标是否有效。

        设置为 true 时,在地图绘制等待时,系统会自动切换成等待光标;为 false 时,则不会自动切换等待光标。

        参数:
        waitCursorEnabled - 当前地图窗口的等待光标是否有效。
      • getEditHistory

        public EditHistory getEditHistory()
        返回地图控件的编辑历史对象。
        返回:
        返回地图控件的编辑历史对象。
      • selectSingleChartObject

        public void selectSingleChartObject(Layer layerChart,
                                            int code,
                                            GeometryType featureType,
                                            int recordID,
                                            boolean isMoveToCenter)
      • selectSingleChartObject

        public void selectSingleChartObject(Layer layerChart,
                                            int code,
                                            GeometryType featureType,
                                            int recordID,
                                            boolean isMoveToCenter,
                                            boolean isClearOldObject)
      • addActionChangedListener

        public void addActionChangedListener(ActionChangedListener l)
        添加一个用于接收操作状态变化事件(ActionChangedEvent)的监听器。
        参数:
        l - 一个用于接收操作状态变化事件的监听器。
      • removeActionChangedListener

        public void removeActionChangedListener(ActionChangedListener l)
        移除一个用于接收操作状态变化事件(ActionChangedEvent)的监听器。
        参数:
        l - 一个用于接收操作状态变化事件的监听器。
      • addGeometrySelectedListener

        public void addGeometrySelectedListener(GeometrySelectedListener l)
        添加一个用于接收选中几何对象事件(GeometrySelectedEvent)的监听器。
        参数:
        l - 一个用于接收选中几何对象事件的监听器。
      • removeGeometrySelectedListener

        public void removeGeometrySelectedListener(GeometrySelectedListener l)
        移除一个用于接收选中几何对象事件(GeometrySelectedEvent)的监听器。
        参数:
        l - 一个用于接收选中几何对象事件的监听器。
      • addGeometrySelectChangedListener

        public void addGeometrySelectChangedListener(GeometrySelectChangedListener l)
        添加一个选中几何对象改变的事件监听器
        参数:
        l - 事件监听器
      • removeGeometrySelectChangedListener

        public void removeGeometrySelectChangedListener(GeometrySelectChangedListener l)
        移除一个选中几何对象改变的事件监听器
        参数:
        l - 事件监听器
      • addGeometryDeletingListener

        public void addGeometryDeletingListener(GeometryDeletingListener l)
        添加一个用于接收删除几何对象事件的监听器。
        参数:
        l - 一个用于接收删除几何对象事件的监听器。
        另请参阅:
        GeometryEvent
      • removeGeometryDeletingListener

        public void removeGeometryDeletingListener(GeometryDeletingListener l)
        移除一个用于接收删除几何对象事件的监听器。
        参数:
        l - 一个用于接收删除几何对象事件的监听器。
        另请参阅:
        GeometryEvent
      • addGeometryDeletedListener

        public void addGeometryDeletedListener(GeometryDeletedListener l)
        添加一个用于接收几何对象删除事件的监听器。
        参数:
        l - 一个用于接收几何对象删除事件的监听器。
        另请参阅:
        GeometryEvent
      • removeGeometryDeletedListener

        public void removeGeometryDeletedListener(GeometryDeletedListener l)
        移除一个用于接收几何对象删除事件的监听器。
        参数:
        l - 一个用于接收几何对象删除事件的监听器。
        另请参阅:
        GeometryEvent
      • addGeometryModifyingListener

        public void addGeometryModifyingListener(GeometryModifyingListener l)
        添加一个用于接收几何对象修改事件的监听器。
        参数:
        l - 一个用于接收几何对象修改事件的监听器。
        另请参阅:
        GeometryEvent
      • removeGeometryModifyingListener

        public void removeGeometryModifyingListener(GeometryModifyingListener l)
        移除一个用于接收几何对象修改事件的监听器。
        参数:
        l - 一个用于接收几何对象修改事件的监听器。
        另请参阅:
        GeometryEvent
      • addGeometryModifiedListener

        public void addGeometryModifiedListener(GeometryModifiedListener l)
        添加一个用于接收几何对象修改结束事件的监听器。
        参数:
        l - 一个用于接收几何对象修改结束事件的监听器。
        另请参阅:
        GeometryEvent
      • removeGeometryModifiedListener

        public void removeGeometryModifiedListener(GeometryModifiedListener l)
        移除一个用于接收几何对象修改结束事件的监听器。
        参数:
        l - 一个用于接收几何对象修改结束事件的监听器。
        另请参阅:
        GeometryEvent
      • addPointInputedListener

        public void addPointInputedListener(PointInputedListener l)
        添加一个用于接收绘制几何对象输入点事件(PointInputedEvent)的监听器。

        在地图上输入点以后触发该事件。

        在地图上绘制空间对象的时候,如果需要对每次输入的点进行坐标调整,可在此事件中处理。

        参数:
        l - 一个用于接收绘制几何对象输入点事件的监听器。
      • removePointInputedListener

        public void removePointInputedListener(PointInputedListener l)
        移除一个用于接收绘制几何对象输入点事件(PointInputedEvent)的监听器。

        在地图上输入点以后触发该事件。

        在地图上绘制空间对象的时候,如果需要对每次输入的点进行坐标调整,可在此事件中处理。

        参数:
        l - 一个用于接收绘制几何对象输入点事件的监听器。
      • addEditHandleBeginListener

        public void addEditHandleBeginListener(EditHandleBeginListener l)
        添加一个用于接收手柄编辑事件的监听器。
        参数:
        l - 一个用于接收手柄编辑事件的监听器。
        另请参阅:
        EditHandleEvent
      • removeEditHandleBeginListener

        public void removeEditHandleBeginListener(EditHandleBeginListener l)
        移除一个用于接收手柄编辑事件的监听器。
        参数:
        l - 一个用于接收手柄编辑事件的监听器。
        另请参阅:
        EditHandleEvent
      • addEditHandleMoveListener

        public void addEditHandleMoveListener(EditHandleMoveListener l)
        添加一个用于接收编辑手柄移动事件的监听器。
        参数:
        l - 一个用于接收编辑手柄移动事件的监听器。
        另请参阅:
        EditHandleEvent
      • removeEditHandleMoveListener

        public void removeEditHandleMoveListener(EditHandleMoveListener l)
        移除一个用于接收编辑手柄移动事件的监听器。
        参数:
        l - 一个用于接收编辑手柄移动事件的监听器。
        另请参阅:
        EditHandleEvent
      • addEditHandleFinishListener

        public void addEditHandleFinishListener(EditHandleFinishListener l)
        添加一个用于接收手柄编辑对象完成事件的监听器。
        参数:
        l - 一个用于接收手柄编辑对象完成事件的监听器。
        另请参阅:
        EditHandleEvent
      • removeEditHandleFinishListener

        public void removeEditHandleFinishListener(EditHandleFinishListener l)
        移除一个用于接收手柄编辑对象完成事件的监听器。
        参数:
        l - 一个用于接收手柄编辑对象完成事件的监听器。
        另请参阅:
        EditHandleEvent
      • addActionCursorChangingListener

        public void addActionCursorChangingListener(ActionCursorChangingListener l)
        添加一个用于接收更新光标事件(ActionCursorChangingEvent)的监听器。

        需要更新光标时触发该事件。

        参数:
        l - 一个用于接收更新光标事件的监听器。
      • removeActionCursorChangingListener

        public void removeActionCursorChangingListener(ActionCursorChangingListener l)
        移除一个用于接收更新光标事件(ActionCursorChangingEvent)的监听器。

        需要更新光标时触发该事件。

        参数:
        l - 一个用于接收更新光标事件的监听器。
      • addTrackingListener

        public void addTrackingListener(TrackingListener l)
        添加一个用于接收跟踪绘制事件(TrackingEvent)的监听器。

        在地图窗口中绘制几何对象(即在内存中跟踪绘制)的时候触发该跟踪绘制事件。

        跟踪绘制即在内存中而不是在数据集中绘制几何对象的过程。

        参数:
        l - 一个用于接收跟踪绘制事件的监听器。
      • removeTrackingListener

        public void removeTrackingListener(TrackingListener l)
        移除一个用于接收跟踪绘制事件(TrackingEvent)的监听器。

        在地图窗口中绘制几何对象(即在内存中跟踪绘制)的时候触发该跟踪绘制事件。

        跟踪绘制即在内存中而不是在跟踪图层中绘制几何对象的过程。

        参数:
        l - 一个用于接收跟踪绘制事件的监听器。
      • addTrackedListener

        public void addTrackedListener(TrackedListener l)
        添加一个用于接收跟踪绘制结束事件(TrackedEvent)的监听器。

        在地图窗口中绘制几何对象结束(即在内存中跟踪绘制结束)的时候触发该跟踪绘制结束事件。

        跟踪绘制结束即表示跟踪绘制完毕的状态。当进行地图编辑时,跟踪绘制的几何对象在绘制完毕后保存到相应的数据集中,当进行跟踪绘制时,跟踪绘制的几何对象并不保存到数据集中,而是仅仅保存在内存中。

        参数:
        l - 一个用于接收跟踪绘制结束事件的监听器。
      • removeTrackedListener

        public void removeTrackedListener(TrackedListener l)
        移除一个用于接收跟踪绘制结束事件(TrackedEvent)的监听器。

        在地图窗口中绘制几何对象结束(即在内存中跟踪绘制结束)的时候触发该跟踪绘制结束事件。

        跟踪绘制结束即表示跟踪绘制完毕的状态。当进行地图编辑时,跟踪绘制的几何对象在绘制完毕后保存到相应的数据集中,当进行地图裁剪时,跟踪绘制的几何对象并不保存到数据集中,而是仅仅保存在内存中。

        参数:
        l - 一个用于接收跟踪绘制结束事件的监听器。
      • addRedoneListener

        public void addRedoneListener(RedoneListener l)
        添加一个用于接收重做事件的监听器。
        参数:
        l - 一个用于接收重做事件的监听器。
      • removeRedoneListener

        public void removeRedoneListener(RedoneListener l)
        移除一个用于接收重做事件的监听器。
        参数:
        l - 一个用于接收重做事件的监听器。
      • addUndoneListener

        public void addUndoneListener(UndoneListener l)
        添加一个用于接收撤销事件的监听器。
        参数:
        l - 一个用于接收撤销事件的监听器。
      • removeUndoneListener

        public void removeUndoneListener(UndoneListener l)
        移除一个用于接收撤销事件的监听器。
        参数:
        l - 一个用于接收撤销事件的监听器。
      • addPaintListener

        public void addPaintListener(PaintListener l)
        添加一个地图窗口绘制事件的监听器
        参数:
        l - 事件监听器
      • removePaintListener

        public void removePaintListener(PaintListener l)
        移除一个地图窗口绘制事件的监听器
        参数:
        l - 事件监听器
      • waitDrawThreadDown

        @Deprecated
        public void waitDrawThreadDown()
        已过时。 
      • waitDrawThreadDown

        @Deprecated
        public void waitDrawThreadDown(boolean setCancel)
        已过时。 
      • run

        public void run()
        指定者:
        run 在接口中 Runnable
      • setDefaultEditGeoStyle

        public void setDefaultEditGeoStyle(GeoStyle style)
        设置地图窗口上编辑对象默认风格
        参数:
        style - 编辑对象默认风格
      • getDefaultEditGeoStyle

        public GeoStyle getDefaultEditGeoStyle()
        获取地图窗口上编辑对象默认风格
        返回:
        编辑对象默认风格
      • setTrackingZoomAndSelectStyle

        public void setTrackingZoomAndSelectStyle(GeoStyle style)
        设置地图窗口上拉框选择等功能辅助线的风格
        参数:
        style - 辅助线风格
      • getTrackingZoomAndSelectStyle

        public GeoStyle getTrackingZoomAndSelectStyle()
        获取地图窗口上拉框选择等功能辅助线的风格
        返回:
        辅助线风格
      • GetSplitedGeoText

        public double[] GetSplitedGeoText(String[] texts)
      • gethandle

        @Deprecated
        public long gethandle()
        已过时。 

Copyright © 2021–2024 SuperMap. All rights reserved.