TextPart (iObjects Java Help)

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

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

- 构造器详细资料
  - 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

类 TextPart

构造器概要

方法概要

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

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

构造器详细资料

TextPart

TextPart

TextPart

TextPart

TextPart

方法详细资料

dispose

getRotation

setRotation

getText

setText

getAnchorPoint

setAnchorPoint

getX

getY

setX

setY

offset

clone

getSign

getDynamicText

setDynamicText