com.supermap.data
类 TextPart3D

java.lang.Object
  com.supermap.data.TextPart3D

public class TextPart3D
extends java.lang.Object

三维文本子对象类。

一个三维文本对象是由一个或多个三维文本子对象构成的，三维文本对象的文字内容是各个子对象的文字内容之和，还可以通过设置各个子对象的放置位置，使一个三维文本对象中的各部分文字具有自己的放置风格。而关于三维文本子对象的文字内容的其他风格，如：文字的对齐方式、字体颜色、字体的大小以及其他文字的风格都由他们所属的三维文本对象的 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(java.lang.String text, double x, double y, double z)
根据指定的参数来构造一个 TextPart3D 的新对象。

TextPart3D(java.lang.String text, Point3D anchorPoint)
根据指定的参数来构造一个 TextPart3D 的新对象。

TextPart3D(TextPart3D part)
根据指定的 TextPart3D 对象构造一个与其完全相同的新对象。

方法摘要

TextPart3D	clone() 返回当前 TextPart3D 对象的一个拷贝。
void	dispose() 释放该对象所占用的资源。
Point3D	getAnchorPoint() 返回此三维文本子对象的锚点，锚点与该子对象的文本对齐方式共同决定该子对象的显示位置。
java.lang.String	getText() 返回此三维文本子对象的文本内容。
double	getX() 返回此三维子对象锚点的 X 坐标。
double	getY() 返回此三维子对象锚点的 Y 坐标。
double	getZ() 返回此三维子对象锚点的 Z 坐标。
void	offset(double dx, double dy, double dz) 将此三维文本子对象的锚点的坐标值调整指定的量。
void	setAnchorPoint(Point3D point3D) 设置此三维文本子对象的锚点，锚点与该子对象的文本对齐方式共同决定该子对象的显示位置。
void	setText(java.lang.String value) 设置此三维文本子对象的文本内容。
void	setX(double value) 设置此三维子对象锚点的 X 坐标。
void	setY(double value) 设置此三维子对象锚点的 Y 坐标。
void	setZ(double value) 设置此三维子对象锚点的 Z 坐标。

从类 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(java.lang.String text,
                  Point3D anchorPoint)

根据指定的参数来构造一个 TextPart3D 的新对象。

参数：

text - 指定的三维文本子对象的文本内容。

anchorPoint - 指定的三维文本子对象的锚点。

TextPart3D

public TextPart3D(java.lang.String text,
                  double x,
                  double y,
                  double z)

根据指定的参数来构造一个 TextPart3D 的新对象。

参数：

text - 指定的三维文本子对象的文本内容。

x - 指定的三维文本子对象锚点的 X 坐标值，单位为度。

y - 指定的三维文本子对象锚点的 Y 坐标值，单位为度。

z - 指定的三维文本子对象锚点的 Z 坐标值，单位为米。

方法详细信息

getAnchorPoint

public Point3D getAnchorPoint()

返回此三维文本子对象的锚点，锚点与该子对象的文本对齐方式共同决定该子对象的显示位置。

返回：

此三维文本子对象的锚点。

默认值:

默认值为{X = 0, Y = 0, Z = 0}。

setAnchorPoint

public void setAnchorPoint(Point3D point3D)

设置此三维文本子对象的锚点，锚点与该子对象的文本对齐方式共同决定该子对象的显示位置。

参数：

point3D - 此三维文本子对象的锚点。

getText

public java.lang.String getText()

返回此三维文本子对象的文本内容。

返回：

此三维文本子对象的文本内容。

默认值:

默认值为一个空的字符串。

setText

public void setText(java.lang.String value)

设置此三维文本子对象的文本内容。

参数：

value - 此三维文本子对象的文本内容。

getX

public double getX()

返回此三维子对象锚点的 X 坐标。单位为度。

返回：

此三维子对象锚点的 X 坐标。单位为度。

默认值:

默认值为 0，单位为度。

setX

public void setX(double value)

设置此三维子对象锚点的 X 坐标。单位为度。

参数：

value - 此三维子对象锚点的 X 坐标。单位为度。

getY

public double getY()

返回此三维子对象锚点的 Y 坐标。单位为度。

返回：

此三维子对象锚点的 Y 坐标。单位为度。

默认值:

默认值为0，单位为度。

setY

public void setY(double value)

设置此三维子对象锚点的 Y 坐标。单位为度。

参数：

value - 此三维子对象锚点的 Y 坐标。单位为度。

getZ

public double getZ()

返回此三维子对象锚点的 Z 坐标。单位为米。

返回：

此三维子对象锚点的 Z 坐标。单位为米。

默认值:

默认值为0，单位为米。

setZ

public void setZ(double value)

设置此三维子对象锚点的 Z 坐标。单位为米。

参数：

value - 此三维子对象锚点的 Z 坐标。单位为米。

offset

public void offset(double dx,
                   double dy,
                   double dz)

将此三维文本子对象的锚点的坐标值调整指定的量。

参数：

dx - 沿 X 轴方向的偏移量。单位为度。

dy - 沿 Y 轴方向的偏移量。单位为度。

dz - 沿 Z 轴方向的偏移量。单位为米。

clone

public TextPart3D clone()

返回当前 TextPart3D 对象的一个拷贝。

覆盖：

类 java.lang.Object 中的 clone

返回：

通过克隆操作得到的 TextPart3D 对象。

dispose

public void dispose()

释放该对象所占用的资源。当调用该方法之后，此对象不再可用。