com.supermap.data

类 TextPart

  • java.lang.Object
    • com.supermap.data.InternalHandle
      • com.supermap.data.InternalHandleDisposable
        • com.supermap.data.TextPart
  • 所有已实现的接口:
    IDisposable


    public class TextPart
    extends com.supermap.data.InternalHandleDisposable
    文本子对象类。

    用于表示文本对象的子对象,其存储子对象的文本,旋转角度,锚点等信息并提供对子对象进行处理的相关方法。

    当该类的实例已被 dispose() 方法释放后,再调用该类成员的时候,则会抛出 ObjectDisposedException 异常。
    示范代码:
    以下代码示范如何将文本子对象添加到文本对象中,并将文本对象输出为 jpg 图片。
     public void textPartTest(){
            // 假设打开一个工作空间 workspace 对象
            // 设置文本子对象
            TextPart textPart = new TextPart();
            textPart.setAnchorPoint(new Point2D(500, 500));
            textPart.setRotation(30);
            textPart.setText("示例");
            textPart.setX(100);
            textPart.setY(100);
            textPart.offset(10.0, 20.0);
    
            // 将子对象添加到文本对象中
            GeoText geotext = new GeoText();
            geotext.addPart(textPart);
    
            // 实例化 Map 对象
            Map map = new Map(workspace);
    
            // 将文本对象添加到地图的跟踪图层,出图显示
            map.getTrackingLayer().add(geotext, "");
            map.setViewBounds(new Rectangle2D(new Point2D(0, 0),
                                              new Point2D(300, 300)));
            map.outputMapToJPG("G:/textPart");
    
            // 释放资源
            textPart.dispose();
            geotext.dispose();
            workspace.dispose();
        }
     
    • 构造器概要

      构造器 
      构造器和说明
      TextPart()
      构造一个新的 TextPart 对象。
      TextPart(String text, double x, double y, double rotation)
      根据指定的参数来构造一个 TextPart 的新对象。
      TextPart(String text, Point2D anchorPoint)
      根据指定的参数来构造一个 TextPart 的新对象。
      TextPart(String text, Point2D anchorPoint, double rotation)
      根据指定的参数来构造一个 TextPart 的新对象。
      TextPart(TextPart part)
      根据指定的 TextPart 对象类构造一个与其完全相同的新对象。
    • 方法概要

      所有方法 实例方法 具体方法 
      限定符和类型 方法和说明
      TextPart clone()
      返回当前 TextPart 对象的一个拷贝。
      void dispose()
      释放此对象所占用的资源。
      Point2D getAnchorPoint()
      返回此文本子对象实例的锚点,其类型为 Point2D
      String getDynamicText()
      返回此TextPart实例动态文本表达式。
      double getRotation()
      返回此文本子对象的旋转角度。
      int getSign()
      返回此TextPart实例是否为动态文本。
      String getText()
      返回此文本子对象的文本内容。
      double getX()
      设置此文本子对象锚点的横坐标。
      double getY()
      返回此文本子对象锚点的纵坐标。
      void offset(double dx, double dy)
      将此文本子对象的偏移指定的量,即将该文本子对象的锚点偏移指定的量。
      void setAnchorPoint(Point2D anchorPoint)
      设置此文本子对象实例的锚点,其类型为 Point2D
      void setDynamicText(String text)
      设置此TextPart动态文本表达式。
      void setRotation(double rotation)
      设置此文本子对象的旋转角度。
      void setText(String text)
      设置此文本子对象的文本内容。
      void setX(double x)
      设置此文本子对象锚点的横坐标。
      void setY(double y)
      设置此文本子对象锚点的纵坐标。
      • 从类继承的方法 com.supermap.data.InternalHandleDisposable

        makeSureNativeObjectLive
    • 构造器详细资料

      • TextPart

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

        其旋转角度为0.0度,文本内容为空,锚点的 isEmpty() 为 true(即 X 坐标和 Y 坐标均为0.0)。

      • TextPart

        public TextPart(TextPart part)
        根据指定的 TextPart 对象类构造一个与其完全相同的新对象。
        参数:
        textpart - 指定的 TextPart 对象。
        抛出:
        ObjectDisposedException - 如果 TextPart 对象已被 dispose() 方法释放后,再被传入。
      • TextPart

        public TextPart(String text,
                        Point2D anchorPoint)
        根据指定的参数来构造一个 TextPart 的新对象。
        参数:
        text - 指定此 TextPart 实例的文本内容。
        anchorPoint - 指定此 TextPart 实例的锚点。
      • TextPart

        public TextPart(String text,
                        Point2D anchorPoint,
                        double rotation)
        根据指定的参数来构造一个 TextPart 的新对象。
        参数:
        text - 指定文本子对象实例的文本内容。
        anchorPoint - 指定文本子对象实例的锚点。
        rotation - 指定文本子对象的旋转角度,以度为单位,逆时针为正方向。
        示范代码:
        请参见 TextStyle 的示例。
      • TextPart

        public TextPart(String text,
                        double x,
                        double y,
                        double rotation)
        根据指定的参数来构造一个 TextPart 的新对象。
        参数:
        text - 指定文本子对象的文本内容。
        x - 指定文本子对象锚点的 X 的值。
        y - 指定文本子对象锚点的 Y 的值。
        rotation - 指定文本子对象的旋转角度,以度为单位,逆时针为正方向。
    • 方法详细资料

      • dispose

        public void dispose()
        释放此对象所占用的资源。当调用该方法之后,此对象不再可用。
      • getRotation

        public double getRotation()
        返回此文本子对象的旋转角度。逆时针为正方向,单位为度。

        文本子对象通过数据引擎存储后返回的旋转角度,精度为 0.1 度;通过构造函数直接构造的文本子对象,返回的旋转角度精度不变。

        返回:
        此文本子对象的旋转角度。
        默认值:
        默认值为 0.0。
      • setRotation

        public void setRotation(double rotation)
        设置此文本子对象的旋转角度。逆时针为正方向,单位为度。
        参数:
        rotation - 此文本子对象的旋转角度。
      • getText

        public String getText()
        返回此文本子对象的文本内容。
        返回:
        String 此文本子对象的文本内容。
        默认值:
        默认值为一个空字符串。
      • setText

        public void setText(String text)
        设置此文本子对象的文本内容。
        参数:
        text - 此文本子对象的文本内容。
      • getAnchorPoint

        public Point2D getAnchorPoint()
        返回此文本子对象实例的锚点,其类型为 Point2D。该锚点与文本的对齐方式共同决定该文本子对象的显示位置。关于锚点与文本的对齐方式如何确定文本子对象的显示位置,请参见 TextAlignment 类。
        返回:
        此文本子对象实例的锚点。
        默认值:
        默认值为 Point2D(0.0,0.0)。
      • setAnchorPoint

        public void setAnchorPoint(Point2D anchorPoint)
        设置此文本子对象实例的锚点,其类型为 Point2D。该锚点与文本的对齐方式共同决定该文本子对象的显示位置。关于锚点与文本的对齐方式如何确定文本子对象的显示位置,请参见 TextAlignment 类。
        参数:
        anchorPoint - 此文本子对象实例的锚点。
      • getX

        public double getX()
        设置此文本子对象锚点的横坐标。
        返回:
        此文本子对象锚点的横坐标。
        默认值:
        默认值为 0。
      • getY

        public double getY()
        返回此文本子对象锚点的纵坐标。
        返回:
        此文本子对象锚点的纵坐标。
        默认值:
        默认值为 0。
      • setX

        public void setX(double x)
        设置此文本子对象锚点的横坐标。
        参数:
        x - 此文本子对象锚点的横坐标。
      • setY

        public void setY(double y)
        设置此文本子对象锚点的纵坐标。
        参数:
        y - 此文本子对象锚点的纵坐标。
      • offset

        public void offset(double dx,
                           double dy)
        将此文本子对象的偏移指定的量,即将该文本子对象的锚点偏移指定的量。
        参数:
        dx - 水平偏移该位置的量。
        dy - 垂直偏移该位置的量。
      • clone

        public TextPart clone()
        返回当前 TextPart 对象的一个拷贝。
        覆盖:
        clone 在类中 Object
        返回:
        通过克隆操作得到的 TextPart 对象。
      • getSign

        public int getSign()
        返回此TextPart实例是否为动态文本。
        返回:
        int
      • getDynamicText

        public String getDynamicText()
        返回此TextPart实例动态文本表达式。
        返回:
        String
      • setDynamicText

        public void setDynamicText(String text)
        设置此TextPart动态文本表达式。
        参数:
        text - String

Copyright © 2021–2024 SuperMap. All rights reserved.