所有类

概要:
嵌套 |
字段 |
构造器 |
方法

详细资料:
字段 |
构造器 |
方法

java.lang.Object
- com.supermap.data.InternalHandle
- - com.supermap.data.InternalHandleDisposable
  - - com.supermap.data.Geometry
    - - com.supermap.data.GeoText

所有已实现的接口:

IDisposable
```
public class GeoText
extends Geometry
```
文本类，派生于 Geometry 类。该类主要用于对地物要素进行标识和必要的注记说明。文本对象由一个或多个部分组成，每个部分称为文本对象的一个子对象，每个子对象都是一个 TextPart 的实例。同一个文本对象的所有子对象都使用相同的文本风格，即使用该文本对象的文本风格进行显示。

构造器概要

构造器
构造器和说明
`GeoText()` 构造一个新的 GeoText 对象。
`GeoText(GeoText geoText)` 根据给定的 GeoText 对象来构造一个与其完全相同的新对象。
`GeoText(TextPart part)` 根据指定的参数来构造一个 GeoText 的新对象。
`GeoText(TextPart part, boolean bHasM)` 据指定的参数来构造一个 GeoText 的新对象,支持设置是否有M值
`GeoText(TextPart part, TextStyle textStyle)` 根据指定的参数来构造一个 GeoText 的新对象。
`GeoText(TextPart part, TextStyle textStyle, boolean bHasM)` 根据指定的参数来构造一个 GeoText 的新对象。

方法概要

所有方法静态方法实例方法具体方法已过时的方法
限定符和类型	方法和说明
`int`	`addPart(TextPart part)` 在文本对象中添加文本子对象。
`GeoText`	`clone()` 返回当前 GeoText 对象的一个拷贝。
`GeoRegion`	`convertToRegion(int segmentCount)` 将文本对象转换为面几何对象。
`void`	`dispose()` 释放对象所占用的资源。
`boolean`	`fromXML(String xml)` 根据传入的 XML 字符串重新构造几何对象。
`GeoStyle`	`getBorderStyle()` 获取矩形文本的文本框风格。
`TextPart`	`getPart(int index)` 返回此文本对象的指定序号的子对象。
`int`	`getPartCount()` 返回文本对象的子对象个数。
`Rectangle2D`	`getRealBounds()` 已过时。
`String`	`getText()` 返回文本对象的内容。
`TextStyle`	`getTextStyle()` 返回文本对象的文本风格。
`Rectangle2D`	`getViewBounds()` 获取矩形文本的文本框范围。
`int`	`indexOf(TextPart part)` 返回指定的子对象在此文本对象中的序号。
`boolean`	`insertPart(int index, TextPart part)` 在此文本对象的指定位置插入一个文本子对象。
`boolean`	`isEmpty()` 判定该文本对象是否为空，即其子对象的个数是否为0。
`boolean`	`isRectangleTextEnabled()` 获取文本对象是否启用矩形文本形式。
`static GeoText`	`makeAlongLineText(String text, GeoLine line)` 创建沿线文本。
`static GeoText`	`makeAlongLineText(String text, GeoLine line, double fixedAngle)` 创建沿线文本。
`boolean`	`removePart(int index)` 删除此文本对象的指定序号的文本子对象。
`void`	`setBorderStyle(GeoStyle style)` 设置矩形文本的文本框风格。
`void`	`setEmpty()` 清空几何对象中的空间数据，但几何对象的标识符和几何风格保持不变。
`boolean`	`setPart(int index, TextPart part)` 修改此文本对象的指定序号的子对象，即用新的文本子对象来替换原来的文本子对象。
`void`	`setRealBounds(Rectangle2D bounds)` 已过时。
`void`	`setRectangleTextEnabled(boolean enable)` 设置文本对象是否启用矩形文本形式。
`void`	`setTextStyle(TextStyle textStyle)` 设置文本对象的文本风格。
`void`	`setViewBounds(Rectangle2D viewBounds)` 设置矩形文本的文本框范围，以左上角为文本框绘制锚点。

从类继承的方法 com.supermap.data.Geometry
addCustomGeometryCreatedListener, getBounds, getHasM, getID, getInnerPoint, getStyle, getType, getVariantID, hitTest, mirror, offset, removeCustomGeometryCreatedListener, resize, rotate, setBounds, setHasM, setID, setStyle, toXML

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

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

- 构造器详细资料
  - GeoText
```
public GeoText()
```
    构造一个新的 GeoText 对象。
  - GeoText
```
public GeoText(GeoText geoText)
```
    根据给定的 GeoText 对象来构造一个与其完全相同的新对象。
    
    参数:
    
    geoText - 指定的 GeoText 对象。
  - GeoText
```
public GeoText(TextPart part)
```
    根据指定的参数来构造一个 GeoText 的新对象。
    
    参数:
    
    part - TextPart子对象。
    
    另请参阅:
    
    TextPart
  - GeoText
```
public GeoText(TextPart part,
               boolean bHasM)
```
    据指定的参数来构造一个 GeoText 的新对象,支持设置是否有M值
    
    参数:
    
    part - TextPart子对象。
    
    bHasM - 是否有M值
    
    从以下版本开始:
    
    12.0.0
  - GeoText
```
public GeoText(TextPart part,
               TextStyle textStyle,
               boolean bHasM)
```
    根据指定的参数来构造一个 GeoText 的新对象。
    
    参数:
    
    part - 指定的文本子对象。
    
    textStyle - 指定的文本风格对象。
    
    bHasM - 是否有M值
    
    从以下版本开始:
    
    12.0.0
  - GeoText
```
public GeoText(TextPart part,
               TextStyle textStyle)
```
    根据指定的参数来构造一个 GeoText 的新对象。
    
    参数:
    
    part - 指定的文本子对象。
    
    textStyle - 指定的文本风格对象。
- 方法详细资料
  - getText
```
public String getText()
```
    返回文本对象的内容。如果该对象有多个子对象时，其值为子对象字符串之和。
    
    返回:
    
    文本对象的内容。
    
    默认值:
    
    默认值为一个空字符串。
  - getPartCount
```
public int getPartCount()
```
    返回文本对象的子对象个数。当文本对象清空后，其子对象的个数为0。
    
    返回:
    
    文本对象的子对象个数。
    
    默认值:
    
    默认值为 0。
  - getTextStyle
```
public TextStyle getTextStyle()
```
    返回文本对象的文本风格。文本风格用于指定文本对象显示时的字体、宽度、高度和颜色等。
    注意：GeoText.getTextStyle().setRotation() 对文本子对象 TextPart 无效，TextPart 的旋转角度由其自身 getRotation() 和 setRotation() 方法来控制。
    
    返回:
    
    文本对象的文本风格。
    
    另请参阅:
    
    TextStyle
    
    示范代码:
    
    请参见 TextStyle 类的示例。
  - setTextStyle
```
public void setTextStyle(TextStyle textStyle)
```
    设置文本对象的文本风格。文本风格用于指定文本对象显示时的字体、宽度、高度和颜色等。
    注意：GeoText.getTextStyle().setRotation() 对文本子对象 TextPart 无效，TextPart 的旋转角度由其自身 getRotation() 和 setRotation() 方法来控制。
    
    参数:
    
    textStyle - 文本对象的文本风格。
    
    另请参阅:
    
    TextStyle
  - isEmpty
```
public boolean isEmpty()
```
    判定该文本对象是否为空，即其子对象的个数是否为0。判断精度为零值判断精度。关于零值判断精度的详细信息请参见 Environment 类。
    
    覆盖:
    
    isEmpty 在类中 Geometry
    
    返回:
    
    如果该文本对象为空，则返回 true；否则返回 false。
    
    另请参阅:
    
    Geometry.offset(double, double)
  - addPart
```
public int addPart(TextPart part)
```
    在文本对象中添加文本子对象。
    
    参数:
    
    part - 一个 TextPart 类的文本子对象。
    
    返回:
    
    当添加成功则返回子对象序号，失败时返回-1。
    
    示范代码:
    
    请参见 TextStyle 的示例。
  - setViewBounds
```
public void setViewBounds(Rectangle2D viewBounds)
```
    设置矩形文本的文本框范围，以左上角为文本框绘制锚点。
    矩形文本，即矩形框中的文本，支持长文本保留字体大小自动换行与高度自适应，确保文本内容完整显示。
    
    参数:
    
    viewBounds - 矩形文本的文本框范围。
    
    抛出:
    
    IllegalStateException - 当文本对象已释放，或者当文本对象子对象个数不为 1。
    
    IllegalArgumentException - 当文本框范围参数为空，或者文本框范围的宽度或高度为非正值（≤0）。
    
    从以下版本开始:
    
    12.0.0
  - getViewBounds
```
public Rectangle2D getViewBounds()
```
    获取矩形文本的文本框范围。
    
    返回:
    
    返回矩形文本的文本框范围。
    
    抛出:
    
    IllegalStateException - 当文本对象已释放。
    
    从以下版本开始:
    
    12.0.0
  - setRectangleTextEnabled
```
public void setRectangleTextEnabled(boolean enable)
```
    设置文本对象是否启用矩形文本形式。
    矩形文本，即矩形框中的文本，支持长文本保留字体大小自动换行与高度自适应，确保文本内容完整显示。
    
    参数:
    
    enable - 如果为true，则启用矩形文本，如果为false，则为普通文本形式。
    
    抛出:
    
    IllegalStateException - 当文本对象已释放，或者当文本对象子对象个数不为 1。
    
    从以下版本开始:
    
    12.0.0
  - isRectangleTextEnabled
```
public boolean isRectangleTextEnabled()
```
    获取文本对象是否启用矩形文本形式。
    
    返回:
    
    如果启用矩形文本，返回true，否则返回false。
    
    抛出:
    
    IllegalStateException - 当文本对象已释放，或者当文本对象子对象个数不为 1。
    
    从以下版本开始:
    
    12.0.0
  - setBorderStyle
```
public void setBorderStyle(GeoStyle style)
```
    设置矩形文本的文本框风格。
    矩形文本，即矩形框中的文本，支持长文本保留字体大小自动换行与高度自适应，确保文本内容完整显示。
    
    参数:
    
    style - 矩形文本的文本框风格。
    
    抛出:
    
    IllegalStateException - 当文本对象已释放。
    
    IllegalArgumentException - 文本框风格参数为空，或者文本框风格对象已释放。
    
    从以下版本开始:
    
    12.0.0
  - getBorderStyle
```
public GeoStyle getBorderStyle()
```
    获取矩形文本的文本框风格。
    
    返回:
    
    返回矩形文本的文本框风格。
    
    抛出:
    
    IllegalStateException - 当文本对象已释放。
    
    从以下版本开始:
    
    12.0.0
  - getPart
```
public TextPart getPart(int index)
```
    返回此文本对象的指定序号的子对象。
    
    参数:
    
    index - 子对象序号。
    
    返回:
    
    指定序号的子对象。
    
    抛出:
    
    IndexOutOfBoundsException - 如果 index 小于零或 index 大于等于该文本对象的子对象个数。
  - insertPart
```
public boolean insertPart(int index,
                          TextPart part)
```
    在此文本对象的指定位置插入一个文本子对象。
    
    参数:
    
    index - 插入子对象的位置，即子对象的序号值。其中序号值大于0且小于子对象的总数。
    
    part - 要插入的文本子对象。
    
    返回:
    
    如果插入成功返回 true，否则返回 false。
    
    抛出:
    
    IndexOutOfBoundsException - 如果 index 小于零或 index 大于该文本对象的子对象个数。
    
    另请参阅:
    
    GeoText.addPart(TextPart), GeoText.removePart(int)
  - indexOf
```
public int indexOf(TextPart part)
```
    返回指定的子对象在此文本对象中的序号。
    
    参数:
    
    part - 指定的文本子对象。
    
    返回:
    
    指定的子对象在此文本对象中的序号。若该子对象不存在，则返回-1。
  - removePart
```
public boolean removePart(int index)
```
    删除此文本对象的指定序号的文本子对象。
    
    参数:
    
    index - 文本子对象序号。
    
    返回:
    
    如果删除成功返回 true，否则返回 false。
    
    抛出:
    
    IndexOutOfBoundsException - 如果 index 小于零或 index 大于等于该文本对象的子对象个数。
  - setPart
```
public boolean setPart(int index,
                       TextPart part)
```
    修改此文本对象的指定序号的子对象，即用新的文本子对象来替换原来的文本子对象。
    
    参数:
    
    index - 文本子对象序号。
    
    part - 文本子对象。
    
    返回:
    
    如果设置成功返回 true，否则返回 false。
    
    抛出:
    
    IndexOutOfBoundsException - 如果 index 小于零或 index 大于等于该文本对象的子对象个数。
  - makeAlongLineText
```
public static GeoText makeAlongLineText(String text,
                                        GeoLine line)
```
    创建沿线文本。将指定的文本沿指定的线对象，从线对象的起始点开始沿线均匀放置。文本中每个字的旋转角度与其所在的线对象上的位置有关。如果线对象有多个子对象，先将线的子对象按照序号首尾相接生成一个新的线对象。再沿新的线对象均匀放置文本。
    
    参数:
    
    text - 一个 String 对象代表将沿线放置的文本。
    
    line - 线对象。
    
    返回:
    
    沿线文本。
  - makeAlongLineText
```
public static GeoText makeAlongLineText(String text,
                                        GeoLine line,
                                        double fixedAngle)
```
    创建沿线文本。将指定的文本沿指定的线对象，从线对象的起始点开始沿线均匀放置。文本中每个字的旋转角度均为指定角度。如果线对象有多个子对象，先将线的子对象按照序号首尾相接生成一个新的线对象。再沿新的线对象均匀放置文本。
    
    参数:
    
    text - 一个 String 对象代表将沿线放置的文本。
    
    line - 线对象。
    
    fixedAngle - 文本子对象的旋转角度，单位为度。
    
    返回:
    
    沿线文本。
  - convertToRegion
```
public GeoRegion convertToRegion(int segmentCount)
```
    将文本对象转换为面几何对象。
    只支持文本风格中的字体名称、粗体、斜体，其他设置将忽略
    
    内部使用固定100像素文本高度计算，并偏移到当前文本对象锚点，外部需要根据实际文本高度进行计算缩放。
    
    参数:
    
    segmentCount - 文字内部笔划中每段控制曲线细分段数，段数越多曲线越平滑,但点数量也越多。值域范围[3,10000],范围外值使用72默认值。
    
    返回:
    
    面几何对象。
    
    抛出:
    
    IllegalStateException - 对象已经被释放
    
    从以下版本开始:
    
    11.2.0
  - clone
```
public GeoText clone()
```
    返回当前 GeoText 对象的一个拷贝。
    
    指定者:
    
    clone 在类中 Geometry
    
    返回:
    
    通过克隆操作得到的 GeoText 对象。
  - setEmpty
```
public void setEmpty()
```
    从类复制的说明: Geometry
    
    清空几何对象中的空间数据，但几何对象的标识符和几何风格保持不变。
    
    覆盖:
    
    setEmpty 在类中 Geometry
  - dispose
```
public void dispose()
```
    释放对象所占用的资源。当调用该方法之后，此对象不再可用。
    
    指定者:
    
    dispose 在接口中 IDisposable
    
    指定者:
    
    dispose 在类中 Geometry
  - fromXML
```
public boolean fromXML(String xml)
```
    从类复制的说明: Geometry
    
    根据传入的 XML 字符串重新构造几何对象。该 XML 必须符合 GML3.0 规范。
    调用该方法时，首先将该几何对象的原始数据清空，然后根据传入的 XML 字符串重新构造该几何对象。
    GML (Geography Markup Language)即地理标识语言， GML 能够表示地理空间对象的空间数据和非空间属性数据。GML 是基于 XML 的空间信息编码标准，由开放式地理信息系统协会 OpenGIS Consortium (OGC) 提出，得到了许多公司的大力支持，如 Oracle、Galdos、MapInfo、CubeWerx 等。
    GML 作为一个空间数据编码规范，提供了一套基本的标签、公共的数据模型，以及用户构建应用模式（GML Application Schemas）的机制。
    
    覆盖:
    
    fromXML 在类中 Geometry
    
    参数:
    
    xml - XML 格式的字符串。
    
    返回:
    
    如果构造成功返回 true，否则返回 false。
    
    另请参阅:
    
    Geometry.offset(double, double)
  - getRealBounds
```
@Deprecated
public Rectangle2D getRealBounds()
```
    已过时。
  - setRealBounds
```
@Deprecated
public void setRealBounds(Rectangle2D bounds)
```
    已过时。

跳过导航链接

所有类

概要:
嵌套 |
字段 |
构造器 |
方法

详细资料:
字段 |
构造器 |
方法

类 GeoText

构造器概要

方法概要

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

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

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

构造器详细资料

GeoText

GeoText

GeoText

GeoText

GeoText

GeoText

方法详细资料

getText

getPartCount

getTextStyle

setTextStyle

isEmpty

addPart

setViewBounds

getViewBounds

setRectangleTextEnabled

isRectangleTextEnabled

setBorderStyle

getBorderStyle

getPart

insertPart

indexOf

removePart

setPart

makeAlongLineText

makeAlongLineText

convertToRegion

clone

setEmpty

dispose

fromXML

getRealBounds

setRealBounds