com.supermap.data
类 TextPart3D
- 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 坐标。
-
-
-
构造器详细资料
-
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 对象的一个拷贝。
-
-
Copyright © 2021–2024 SuperMap. All rights reserved.