TextPart3D (iObjects Java Help)

java.lang.Object
- com.supermap.data.InternalHandle
- - com.supermap.data.InternalHandleDisposable
  - - com.supermap.data.TextPart3D

所有已实现的接口:: IDisposable

public class TextPart3D
extends com.supermap.data.InternalHandleDisposable

三维文本子对象类。

一个三维文本对象是由一个或多个三维文本子对象构成的，三维文本对象的文字内容是各个子对象的文字内容之和，还可以通过设置各个子对象的放置位置，使一个三维文本对象中的各部分文字具有自己的放置风格。而关于三维文本子对象的文字内容的其他风格，如：文字的对齐方式、字体颜色、字体的大小以及其他文字的风格都由他们所属的三维文本对象的 setTextStyle() 方法设置来统一决定。具体内容，请参见 GeoText3D 类。

当该类的实例已被 dispose() 方法释放后，再调用该类成员的时候，则抛出 ObjectDisposedException 异常。

示范代码:

以下代码示范如何构造一个三维文本子对象，并将其添加到三维文本几何对象中，将三维文本几何对象添加到 SceneControl 的图层中。

 public void textPart3DTest(){
        
        // 构造一个三维文本子对象，设置三维文本子对象
        TextPart3D textPart3D = new TextPart3D();
        textPart3D.setAnchorPoint(new Point3D(22, 50, 45));
        textPart3D.setText("示例");
        textPart3D.setX(22.5);
        textPart3D.setY(52.2);
        textPart3D.setZ(45.0);

        // 对三维文本子对象进行平移操作
        textPart3D.offset(2, 5, 6);

        // 用三维文本子对象构造一个三维文本几何对象
        GeoText3D geoText3D = new GeoText3D(textPart3D);

        // 构造一个 SceneControl 对象并将上面得到的三维对象添加到第0号图层中
        SceneControl scenecontrol = new SceneControl();
        
        Layer3D layer3D = scenecontrol.getScene().getLayers().get(0);
        //layer3D.getFeatures()方法只针对KML类型三维图层，当为其他类型的图层时，返回值为null。
        if(layer3D.getFeatures()!=null)
            {
                layer3D.getFeatures().add(geoText3D);
            }
            else
            {
               JOptionPane.showMessageDialog(null, "获取三维要素集合对象失败，必须为KML类型的三维图层。");
            }

        // 释放对象和 SceneControl 对象
        geoText3D.dispose();
        scenecontrol.dispose();
    }

构造器概要

构造器
构造器和说明
`TextPart3D()` 构造一个新的 TextPart3D 对象。
`TextPart3D(String text, double x, double y, double z)` 根据指定的参数来构造一个 TextPart3D 的新对象。
`TextPart3D(String text, Point3D anchorPoint)` 根据指定的参数来构造一个 TextPart3D 的新对象。
`TextPart3D(TextPart3D part)` 根据指定的 TextPart3D 对象构造一个与其完全相同的新对象。

方法概要

所有方法实例方法具体方法
限定符和类型	方法和说明
`TextPart3D`	`clone()` 返回当前 TextPart3D 对象的一个拷贝。
`void`	`dispose()` 释放该对象所占用的资源。
`Point3D`	`getAnchorPoint()` 返回此三维文本子对象的锚点，锚点与该子对象的文本对齐方式共同决定该子对象的显示位置。
`String`	`getText()` 返回此三维文本子对象的文本内容。
`double`	`getX()` 返回此三维子对象锚点的 X 坐标。
`double`	`getY()` 返回此三维子对象锚点的 Y 坐标。
`double`	`getZ()` 返回此三维子对象锚点的 Z 坐标。
`void`	`offset(double dx, double dy, double dz)` 将此三维文本子对象的锚点的坐标值调整指定的量。
`void`	`setAnchorPoint(Point3D anchorPoint)` 设置此三维文本子对象的锚点，锚点与该子对象的文本对齐方式共同决定该子对象的显示位置。
`void`	`setText(String text)` 设置此三维文本子对象的文本内容。
`void`	`setX(double x)` 设置此三维子对象锚点的 X 坐标。
`void`	`setY(double y)` 设置此三维子对象锚点的 Y 坐标。
`void`	`setZ(double z)` 设置此三维子对象锚点的 Z 坐标。

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

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

- 构造器详细资料
  - TextPart3D
```
public TextPart3D()
```
    构造一个新的 TextPart3D 对象。
  - TextPart3D
```
public TextPart3D(TextPart3D part)
```
    根据指定的 TextPart3D 对象构造一个与其完全相同的新对象。
    
    参数:
    
    part - 指定的 TextPart3D 对象。
    
    抛出:
    
    ObjectDisposedException - 当指定的三维文本对象已被 dispose() 方法释放后，再传入时。
  - TextPart3D
```
public TextPart3D(String text,
                  Point3D anchorPoint)
```
    根据指定的参数来构造一个 TextPart3D 的新对象。
    
    参数:
    
    text - 指定的三维文本子对象的文本内容。
    
    anchorPoint - 指定的三维文本子对象的锚点。
  - TextPart3D
```
public TextPart3D(String text,
                  double x,
                  double y,
                  double z)
```
    根据指定的参数来构造一个 TextPart3D 的新对象。
    
    参数:
    
    text - 指定的三维文本子对象的文本内容。
    
    x - 指定的三维文本子对象锚点的 X 坐标值，单位为度。
    
    y - 指定的三维文本子对象锚点的 Y 坐标值，单位为度。
    
    z - 指定的三维文本子对象锚点的 Z 坐标值，单位为米。
- 方法详细资料
  - dispose
```
public void dispose()
```
    释放该对象所占用的资源。当调用该方法之后，此对象不再可用。
  - getText
```
public String getText()
```
    返回此三维文本子对象的文本内容。
    
    返回:
    
    此三维文本子对象的文本内容。
    
    默认值:
    
    默认值为一个空的字符串。
  - setText
```
public void setText(String text)
```
    设置此三维文本子对象的文本内容。
    
    参数:
    
    value - 此三维文本子对象的文本内容。
  - getAnchorPoint
```
public Point3D getAnchorPoint()
```
    返回此三维文本子对象的锚点，锚点与该子对象的文本对齐方式共同决定该子对象的显示位置。
    
    返回:
    
    此三维文本子对象的锚点。
    
    默认值:
    
    默认值为{X = 0, Y = 0, Z = 0}。
  - setAnchorPoint
```
public void setAnchorPoint(Point3D anchorPoint)
```
    设置此三维文本子对象的锚点，锚点与该子对象的文本对齐方式共同决定该子对象的显示位置。
    
    参数:
    
    point3D - 此三维文本子对象的锚点。
  - getX
```
public double getX()
```
    返回此三维子对象锚点的 X 坐标。单位为度。
    
    返回:
    
    此三维子对象锚点的 X 坐标。单位为度。
    
    默认值:
    
    默认值为 0，单位为度。
  - getY
```
public double getY()
```
    返回此三维子对象锚点的 Y 坐标。单位为度。
    
    返回:
    
    此三维子对象锚点的 Y 坐标。单位为度。
    
    默认值:
    
    默认值为0，单位为度。
  - setX
```
public void setX(double x)
```
    设置此三维子对象锚点的 X 坐标。单位为度。
    
    参数:
    
    value - 此三维子对象锚点的 X 坐标。单位为度。
  - setY
```
public void setY(double y)
```
    设置此三维子对象锚点的 Y 坐标。单位为度。
    
    参数:
    
    value - 此三维子对象锚点的 Y 坐标。单位为度。
  - getZ
```
public double getZ()
```
    返回此三维子对象锚点的 Z 坐标。单位为米。
    
    返回:
    
    此三维子对象锚点的 Z 坐标。单位为米。
    
    默认值:
    
    默认值为0，单位为米。
  - setZ
```
public void setZ(double z)
```
    设置此三维子对象锚点的 Z 坐标。单位为米。
    
    参数:
    
    value - 此三维子对象锚点的 Z 坐标。单位为米。
  - offset
```
public void offset(double dx,
                   double dy,
                   double dz)
```
    将此三维文本子对象的锚点的坐标值调整指定的量。
    
    参数:
    
    dx - 沿 X 轴方向的偏移量。单位为度。
    
    dy - 沿 Y 轴方向的偏移量。单位为度。
    
    dz - 沿 Z 轴方向的偏移量。单位为米。
  - clone
```
public TextPart3D clone()
```
    返回当前 TextPart3D 对象的一个拷贝。
    
    覆盖:
    
    clone 在类中 Object
    
    返回:
    
    通过克隆操作得到的 TextPart3D 对象。

类 TextPart3D

构造器概要

方法概要

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

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

构造器详细资料

TextPart3D

TextPart3D

TextPart3D

TextPart3D

方法详细资料

dispose

getText

setText

getAnchorPoint

setAnchorPoint

getX

getY

setX

setY

getZ

setZ

offset

clone