Class MTextEnt

多行文本类

继承自基础实体类，用于处理多行文本的显示和编辑。支持自动换行、行间距调整、多种对齐方式等功能。

Example

import { MTextEnt, Point2D, Engine } from '@aspect/webcad-lib-ts';

// 创建多行文本
const mtext = new MTextEnt(new Point2D(100, 100), "多行文本\\P第二行", 10, 0, 200);
mtext.setDefaults();

// 添加到画布
Engine.addEntities(mtext);

Hierarchy (View Summary)

EntityBase
- MTextEnt

Index

Constructors

constructor

Properties

objectId id _lineType _isAlive isDirty block? type textStyle

Constructors

constructor

new MTextEnt(
    insertionPoint: Point2D,
    textString: string,
    height: number,
    rotation: number,
    textAttachment: number,
    rowSpcFac?: number,
    font?: string,
    color?: number,
    contents?: string,
    maxWidth?: number,
): MTextEnt
多行文本构造函数
Parameters
- insertionPoint: Point2D
  插入点坐标
- textString: string
  文本字符串
- height: number
  文本高度
- rotation: number
  旋转角度
- textAttachment: number
  文本附着点
- rowSpcFac: number = SystemConstants.MTEXT_rowSpcFac
  行间距因子，默认为S.MTEXT_rowSpcFac
- font: string = ""
  字体名称
- color: number = 256
  颜色索引，默认为256
- contents: string = ""
  MText格式化内容字符串，默认为空字符串
- maxWidth: number = 0
  最大宽度，默认为0（无限制）
Returns MTextEnt
Overrides EntityBase.constructor
- Defined in entities/MTextEnt.ts:194

Properties

objectId

objectId: string

DWG对象ID（句柄）- 从DWG文件导入时的唯一标识符这个值不应该在克隆时复制，新创建的实体应该为空字符串

id

id: number

实体索引ID - 从1开始递增的唯一索引用于在WebCAD格式中标识实体

_lineType

_lineType: string

_isAlive

_isAlive: boolean

isDirty

isDirty: boolean

是否处于脏状态，供渲染器增量更新

`Optional`block

block?: any

type

type: string

实体类型标识符（如"LINE"、"CIRCLE"等）

textStyle

textStyle: TextStyle

Accessors

color

get color(): number
获取颜色索引

Returns number
颜色索引值（256表示"随图层"颜色）
Inherited from EntityBase.color
- Defined in entities/EntityBase.ts:116
set color(value: number): void
设置颜色索引
Parameters
- value: number
  颜色索引值（256表示"随图层"颜色）
Returns void
Inherited from EntityBase.color
- Defined in entities/EntityBase.ts:125

layerId

get layerId(): string
获取图层ID

Returns string
图层ID字符串
Inherited from EntityBase.layerId
- Defined in entities/EntityBase.ts:137
set layerId(value: string): void
设置图层ID
Parameters
- value: string
  图层ID字符串
Returns void
Inherited from EntityBase.layerId
- Defined in entities/EntityBase.ts:146

lineTypeScale

get lineTypeScale(): number
获取线型比例

Returns number
线型比例因子
Inherited from EntityBase.lineTypeScale
- Defined in entities/EntityBase.ts:158
set lineTypeScale(value: number): void
设置线型比例
Parameters
- value: number
  线型比例因子
Returns void
Inherited from EntityBase.lineTypeScale
- Defined in entities/EntityBase.ts:167

lineWeight

get lineWeight(): number
获取线宽

Returns number
线宽值（-1=ByLayer, -2=ByBlock, >=0为具体值，单位为0.01mm）
Inherited from EntityBase.lineWeight
- Defined in entities/EntityBase.ts:179
set lineWeight(value: number): void
设置线宽
Parameters
- value: number
  线宽值（-1=ByLayer, -2=ByBlock, >=0为具体值）
Returns void
Inherited from EntityBase.lineWeight
- Defined in entities/EntityBase.ts:188

transpMgr

get transpMgr(): TransparencyManager
获取透明度管理器

Returns TransparencyManager
透明度管理器实例
Inherited from EntityBase.transpMgr
- Defined in entities/EntityBase.ts:200
set transpMgr(value: TransparencyManager): void
设置透明度管理器
Parameters
- value: TransparencyManager
  透明度管理器实例
Returns void
Inherited from EntityBase.transpMgr
- Defined in entities/EntityBase.ts:209

xdataRaw

get xdataRaw(): Record<string, string>
获取原始扩展数据（用于序列化）格式: { "1001": "AppName", "1000": "JSON字符串" }

Returns Record<string, string>
原始xdata对象或undefined
Inherited from EntityBase.xdataRaw
- Defined in entities/EntityBase.ts:242
set xdataRaw(value: Record<string, string>): void
设置原始扩展数据（从数据库加载时使用）
Parameters
- value: Record<string, string>
  原始xdata对象
Returns void
Inherited from EntityBase.xdataRaw
- Defined in entities/EntityBase.ts:251

extData

get extData(): Record<string, any>
获取扩展数据（用户友好格式）自动解析JSON字符串返回对象

Returns Record<string, any>
解析后的扩展数据对象，或undefined
Example
```
const data = entity.extData;
console.log(data?.sensorVal); // 10
```
Inherited from EntityBase.extData
- Defined in entities/EntityBase.ts:267

extDataAppName

get extDataAppName(): string
获取扩展数据的应用程序名（AppName）

Returns string
AppName字符串，或undefined
Inherited from EntityBase.extDataAppName
- Defined in entities/EntityBase.ts:281

doc

get doc(): any
获取所属文档

通过实体所在的块来获取文档对象。在CAD系统中，实体总是属于某个块，而块又属于某个文档。

Returns any
文档对象，如果无法获取则返回undefined
Inherited from EntityBase.doc
- Defined in entities/EntityBase.ts:337

layer

get layer(): string
获取图层名称

根据实体的layerId从文档的图层集合中查找对应的图层名称。如果找不到对应的图层，则返回默认图层"0"。

Returns string
图层名称，默认为"0"
Inherited from EntityBase.layer
- Defined in entities/EntityBase.ts:350
set layer(layerName: string): void
设置图层名称

根据图层名称查找对应的图层ID并设置给实体。如果找不到指定的图层，则使用默认图层ID（"0"）。

注意：优先使用实体所属文档的图层列表，如果实体尚未添加到文档，则使用 Engine.currentDoc 的图层列表。
Parameters
- layerName: string
  图层名称
Returns void
Inherited from EntityBase.layer
- Defined in entities/EntityBase.ts:367

lineType

get lineType(): string
获取线型

返回实体当前的线型设置。线型控制线条的显示样式（如实线、虚线、点划线等）。

Returns string
线型名称
Inherited from EntityBase.lineType
- Defined in entities/EntityBase.ts:384
set lineType(lineTypeName: string): void
设置线型

设置实体的线型，支持标准CAD线型、常见别名和自定义线型。输入的线型名称会被转换为大写进行匹配。

支持的线型：
- CONTINUOUS: 连续线（实线）
- HIDDEN/DASHED: 虚线（虚线）
- CENTER: 中心线
- PHANTOM: 幻影线
- DOT: 点线（映射为虚线）
- 自定义线型：通过LinetypeManager管理的线型
Parameters
- lineTypeName: string
  线型名称
Returns void
Inherited from EntityBase.lineType
- Defined in entities/EntityBase.ts:405

styleName

get styleName(): string
获取文本样式名称

Returns string
文本样式名称
- Defined in entities/MTextEnt.ts:88
set styleName(value: string): void
设置文本样式名称

当设置样式名称时，会自动从文档的文本样式集合中获取对应的样式对象并设置。
Parameters
- value: string
  新的文本样式名称
Returns void
- Defined in entities/MTextEnt.ts:99

isAlive

get isAlive(): boolean
重写isAlive属性的setter

Returns boolean
Overrides EntityBase.isAlive
- Defined in entities/MTextEnt.ts:115
set isAlive(value: boolean): void
获取实体存活状态
Parameters
- value: boolean
Returns void
是否存活（true表示有效，false表示已删除）
Overrides EntityBase.isAlive
- Defined in entities/MTextEnt.ts:119

insertionPoint

get insertionPoint(): Point2D
Returns Point2D
- Defined in entities/MTextEnt.ts:274
set insertionPoint(val: PointInput): void
Parameters
- val: PointInput
Returns void
- Defined in entities/MTextEnt.ts:278

font

get font(): string
Returns string
- Defined in entities/MTextEnt.ts:284
set font(val: string): void
Parameters
- val: string
Returns void
- Defined in entities/MTextEnt.ts:288

rowSpcFac

get rowSpcFac(): number
Returns number
- Defined in entities/MTextEnt.ts:295
set rowSpcFac(val: number): void
Parameters
- val: number
Returns void
- Defined in entities/MTextEnt.ts:299

flowDirection

get flowDirection(): number
FlowDirection (AutoCAD 兼容) 1=LtoR, 2=RtoL, 3=TtoB, 4=BtoT, 5=ByStyle

Returns number
- Defined in entities/MTextEnt.ts:310
set flowDirection(val: number): void
Parameters
- val: number
Returns void
- Defined in entities/MTextEnt.ts:314

lineSpacingStyle

get lineSpacingStyle(): number
行距样式 (kAtLeast=1, kExactly=2)

Returns number
- Defined in entities/MTextEnt.ts:324
set lineSpacingStyle(val: number): void
Parameters
- val: number
Returns void
- Defined in entities/MTextEnt.ts:328

columnType

get columnType(): number
列类型 (kNoColumns=1, kStaticColumns=2, kDynamicColumns=3)

Returns number
- Defined in entities/MTextEnt.ts:338
set columnType(val: number): void
Parameters
- val: number
Returns void
- Defined in entities/MTextEnt.ts:342

refWidth

get refWidth(): number
参考宽度（等同于 AutoCAD 的 definedWidth / 本类的 maxWidth） .webcad JSON 中的 refWidth 与此等价

Returns number
- Defined in entities/MTextEnt.ts:353
set refWidth(val: number): void
Parameters
- val: number
Returns void
- Defined in entities/MTextEnt.ts:357

definedHeight

get definedHeight(): number
参考高度 / 定义高度当前几何未使用，仅用于向 WASM 传递 MText 相关信息

Returns number
- Defined in entities/MTextEnt.ts:365
set definedHeight(val: number): void
Parameters
- val: number
Returns void
- Defined in entities/MTextEnt.ts:369

backgroundFill

get backgroundFill(): boolean
背景填充开关控制是否显示文本背景遮罩

Returns boolean
- Defined in entities/MTextEnt.ts:380
set backgroundFill(val: boolean): void
Parameters
- val: boolean
Returns void
- Defined in entities/MTextEnt.ts:384

backgroundConfig

get backgroundConfig(): { color: number; scaleFactor: number }
背景填充配置包含背景颜色和比例因子

Returns { color: number; scaleFactor: number }
- Defined in entities/MTextEnt.ts:395
set backgroundConfig(val: { color: number; scaleFactor: number }): void
Parameters
- val: { color: number; scaleFactor: number }
Returns void
- Defined in entities/MTextEnt.ts:399

backgroundFillColor

get backgroundFillColor(): number
背景颜色快捷访问背景填充配置中的颜色

Returns number
- Defined in entities/MTextEnt.ts:410
set backgroundFillColor(val: number): void
Parameters
- val: number
Returns void
- Defined in entities/MTextEnt.ts:414

backgroundScaleFactor

get backgroundScaleFactor(): number
背景比例因子快捷访问背景填充配置中的比例因子

Returns number
- Defined in entities/MTextEnt.ts:425
set backgroundScaleFactor(val: number): void
Parameters
- val: number
Returns void
- Defined in entities/MTextEnt.ts:429

charUnitW

get charUnitW(): number
获取单字符单位宽度

Returns number
单字符宽度
- Defined in entities/MTextEnt.ts:442

charDoubleUnitW

get charDoubleUnitW(): number
获取双字符单位宽度

Returns number
双字符宽度
- Defined in entities/MTextEnt.ts:450

lineSpacingFactor

get lineSpacingFactor(): number
获取行间距因子（AutoCAD兼容格式）返回符合AutoCAD标准的行间距因子值

Returns number
行间距因子
- Defined in entities/MTextEnt.ts:616

showBorder

get showBorder(): boolean
获取边框显示状态

Returns boolean
是否显示边框
- Defined in entities/MTextEnt.ts:655
set showBorder(showBorderFlag: boolean): void
设置边框显示状态控制文本边框的显示和隐藏
Parameters
- showBorderFlag: boolean
  是否显示边框
Returns void
- Defined in entities/MTextEnt.ts:664

rotation

get rotation(): number
获取旋转角度

Returns number
旋转角度（弧度）
- Defined in entities/MTextEnt.ts:675
set rotation(rotationAngle: number): void
设置旋转角度设置文本的旋转角度，同时更新相关的几何计算
Parameters
- rotationAngle: number
  旋转角度（弧度）
Returns void
- Defined in entities/MTextEnt.ts:684

textAlign

get textAlign(): string
获取文本对齐方式

Returns string
文本对齐方式（left/center/right）
- Defined in entities/MTextEnt.ts:703
set textAlign(textAlignment: string): void
设置文本对齐方式设置文本的水平对齐方式
Parameters
- textAlignment: string
  对齐方式（left/center/right）
Returns void
- Defined in entities/MTextEnt.ts:712

textAttachment

get textAttachment(): number
获取文本附着点

Returns number
文本附着点枚举值
- Defined in entities/MTextEnt.ts:722
set textAttachment(textAttachmentValue: number): void
设置文本附着点设置文本相对于插入点的附着位置
Parameters
- textAttachmentValue: number
  文本附着点枚举值
Returns void
- Defined in entities/MTextEnt.ts:731

rowSpcDist

get rowSpcDist(): number
获取行间距距离计算实际的行间距像素值

Returns number
行间距距离
- Defined in entities/MTextEnt.ts:744

height

get height(): number
获取文本高度

Returns number
文本高度
- Defined in entities/MTextEnt.ts:752
set height(textHeight: number): void
设置文本高度设置文本的字体高度，影响文本显示大小
Parameters
- textHeight: number
  文本高度
Returns void
- Defined in entities/MTextEnt.ts:761

maxWidth

get maxWidth(): number
获取最大宽度

Returns number
文本框最大宽度
- Defined in entities/MTextEnt.ts:773
set maxWidth(maxWidthValue: number): void
设置最大宽度设置文本框的最大宽度，影响自动换行
Parameters
- maxWidthValue: number
  最大宽度值
Returns void
- Defined in entities/MTextEnt.ts:782

wordWrapColmn

get wordWrapColmn(): number
获取自动换行列数根据最大宽度和字符宽度计算可容纳的字符列数

Returns number
自动换行列数
- Defined in entities/MTextEnt.ts:798
set wordWrapColmn(wordWrapColumnCount: number): void
设置自动换行列数根据指定的列数设置文本框的最大宽度
Parameters
- wordWrapColumnCount: number
  自动换行列数
Returns void
- Defined in entities/MTextEnt.ts:812

textString

get textString(): string
获取文本字符串

Returns string
文本内容
- Defined in entities/MTextEnt.ts:918
set textString(value: string): void
设置文本字符串设置文本内容，自动处理换行符转换和Unicode解码并更新显示注意：普通换行符 \n 会自动转换为 MText 格式的 \P
Parameters
- value: string
  文本内容
Returns void
- Defined in entities/MTextEnt.ts:928

text

get text(): string
获取文本内容（textString 的别名）

Returns string
文本字符串内容
- Defined in entities/MTextEnt.ts:942
set text(newText: string): void
设置文本内容（textString 的别名）
Parameters
- newText: string
  新的文本字符串
Returns void
- Defined in entities/MTextEnt.ts:950

get contents(): string
获取MText格式化内容字符串

Returns string
MText格式化内容
- Defined in entities/MTextEnt.ts:958
set contents(value: string): void
设置MText格式化内容字符串设置MText格式化内容，当内容不为空且与textString不同时，会触发解析
Parameters
- value: string
  MText格式化内容
Returns void
- Defined in entities/MTextEnt.ts:967

curWidth

get curWidth(): number
获取当前宽度

Returns number
文本当前实际宽度
- Defined in entities/MTextEnt.ts:981

rowCount

get rowCount(): number
获取行数

Returns number
文本行数
- Defined in entities/MTextEnt.ts:989
set rowCount(value: number): void
设置行数
Parameters
- value: number
  文本行数
Returns void
- Defined in entities/MTextEnt.ts:997

pt1

get pt1(): Point2D
获取内部文本框关键点1（左下角）从 WASM 渲染阶段写回的角点中获取左下角点（世界坐标）。

Returns Point2D
左下角坐标
- Defined in entities/MTextEnt.ts:1086

pt2

get pt2(): Point2D
获取内部文本框关键点2（底部中心）从 WASM 渲染阶段写回的角点中计算底边中点（世界坐标）。

Returns Point2D
底部中心坐标
- Defined in entities/MTextEnt.ts:1095

pt3

get pt3(): Point2D
获取内部文本框关键点3（右下角）从 WASM 渲染阶段写回的角点中获取右下角点（世界坐标）。

Returns Point2D
右下角坐标
- Defined in entities/MTextEnt.ts:1108

pt4

get pt4(): Point2D
获取内部文本框关键点4（左侧中心）从 WASM 渲染阶段写回的角点中计算左边中点（世界坐标）。

Returns Point2D
左侧中心坐标
- Defined in entities/MTextEnt.ts:1117

pt5

get pt5(): Point2D
获取内部文本框关键点5（中心点）从 WASM 渲染阶段写回的角点中计算中心点（世界坐标）。

Returns Point2D
中心点坐标
- Defined in entities/MTextEnt.ts:1130

pt6

get pt6(): Point2D
获取内部文本框关键点6（右侧中心）从 WASM 渲染阶段写回的角点中计算右边中点（世界坐标）。

Returns Point2D
右侧中心坐标
- Defined in entities/MTextEnt.ts:1143

pt7

get pt7(): Point2D
获取内部文本框关键点7（左上角）从 WASM 渲染阶段写回的角点中获取左上角点（世界坐标）。

Returns Point2D
左上角坐标
- Defined in entities/MTextEnt.ts:1156

pt8

get pt8(): Point2D
获取内部文本框关键点8（顶部中心）从 WASM 渲染阶段写回的角点中计算顶边中点（世界坐标）。

Returns Point2D
顶部中心坐标
- Defined in entities/MTextEnt.ts:1165

pt9

get pt9(): Point2D
获取内部文本框关键点9（右上角）从 WASM 渲染阶段写回的角点中获取右上角点（世界坐标）。

Returns Point2D
右上角坐标
- Defined in entities/MTextEnt.ts:1178

opt1

get opt1(): Point2D
Returns Point2D
- Defined in entities/MTextEnt.ts:1183

opt2

get opt2(): Point2D
Returns Point2D
- Defined in entities/MTextEnt.ts:1184

opt3

get opt3(): Point2D
Returns Point2D
- Defined in entities/MTextEnt.ts:1185

opt4

get opt4(): Point2D
Returns Point2D
- Defined in entities/MTextEnt.ts:1186

opt5

get opt5(): Point2D
Returns Point2D
- Defined in entities/MTextEnt.ts:1187

opt6

get opt6(): Point2D
Returns Point2D
- Defined in entities/MTextEnt.ts:1188

opt7

get opt7(): Point2D
Returns Point2D
- Defined in entities/MTextEnt.ts:1189

opt8

get opt8(): Point2D
Returns Point2D
- Defined in entities/MTextEnt.ts:1190

opt9

get opt9(): Point2D
Returns Point2D
- Defined in entities/MTextEnt.ts:1191

Methods

setExtData

setExtData(appName: string, data: Record<string, any>): void
设置扩展数据（用户友好格式）自动将对象序列化为JSON字符串存储
Parameters
- appName: string
  应用程序名（用于在DWG中标识数据来源）
- data: Record<string, any>
  要存储的数据对象（将被序列化为JSON）
Returns void
Example
```
entity.setExtData("MY_SENSOR", {
  sensorVal: 10,
  deviceName: "温度传感器",
  isActive: true
});
```
Inherited from EntityBase.setExtData
- Defined in entities/EntityBase.ts:300

clearExtData

clearExtData(): void
清除扩展数据

Returns void
Inherited from EntityBase.clearExtData
- Defined in entities/EntityBase.ts:312

hasExtData

hasExtData(): boolean
检查是否有扩展数据

Returns boolean
是否存在扩展数据
Inherited from EntityBase.hasExtData
- Defined in entities/EntityBase.ts:322

fromDefaultProps

fromDefaultProps(defaultPropsObject: any): this
从默认属性对象复制属性

将指定的默认属性对象的所有相关属性复制到当前实体。这通常用于创建新实体时应用默认设置。
Parameters
- defaultPropsObject: any
  默认属性对象，包含layer、colorIndex、lineType等属性
Returns this
当前实例（支持链式调用）
Inherited from EntityBase.fromDefaultProps
- Defined in entities/EntityBase.ts:469

setDefaults

setDefaults(): void
设置为系统默认值

从全局CAD系统设置中获取当前的默认属性值并应用到实体。这些默认值包括当前图层、当前颜色、当前线型等。

使用的全局变量：
- Engine.currentDoc.CLAYER: 当前图层名称
- Engine.CECOLOR: 当前实体颜色
- Engine.CELTYPE: 当前实体线型
- Engine.CELTSCALE: 当前实体线型比例
Returns void
Inherited from EntityBase.setDefaults
- Defined in entities/EntityBase.ts:531

fromDbDefaultProps

fromDbDefaultProps(dbPropsObject: any): this
从数据库默认属性对象设置属性

从数据库查询结果或序列化数据中恢复实体属性。这个方法处理数据库中可能存在的空值和默认值情况。
Parameters
- dbPropsObject: any
  数据库属性对象，包含layerId、colorIndex等属性
Returns this
当前实例（支持链式调用）
Inherited from EntityBase.fromDbDefaultProps
- Defined in entities/EntityBase.ts:551

mapToDbDefaultProps

mapToDbDefaultProps(targetDbObject: any): any
将属性映射到数据库默认属性对象

将当前实体的属性映射到数据库存储格式的对象中。用于保存实体数据到数据库或序列化。
Parameters
- targetDbObject: any
  目标数据库属性对象
Returns any
映射后的属性对象
Inherited from EntityBase.mapToDbDefaultProps
- Defined in entities/EntityBase.ts:609

setModified

setModified(): void
通知渲染系统此实体已被修改。在桶渲染模式下，这将标记对应的桶为"脏"，以便在下次 regenPartial 时重绘。注意：此方法只标记，不触发重绘。调用方需要在适当的时候（如命令结束时）调用 regenPartial()。

Returns void
Inherited from EntityBase.setModified
- Defined in entities/EntityBase.ts:655

calculateUnifiedBaselineAdjustments

calculateUnifiedBaselineAdjustments(): {
    thadjOffset: number;
    chineseBaselineAdjust: number;
    chineseTopReduction: number;
    chineseBottomBoost: number;
    baselineToTopOffset: number;
    textHeightAdjustment: number;
    verticalOffset: number;
    baselineOffset: number;
    adjustedLineSpacing: number;
}
计算统一的文字基线调整偏移量这个方法确保简单文本和复杂文本使用相同的基线调整逻辑

Returns {
    thadjOffset: number;
    chineseBaselineAdjust: number;
    chineseTopReduction: number;
    chineseBottomBoost: number;
    baselineToTopOffset: number;
    textHeightAdjustment: number;
    verticalOffset: number;
    baselineOffset: number;
    adjustedLineSpacing: number;
}
包含各种偏移量的对象
- Defined in entities/MTextEnt.ts:131

hasChineseCharacters

hasChineseCharacters(): boolean
检测文本是否包含中文字符

Returns boolean
是否包含中文字符
- Defined in entities/MTextEnt.ts:458

cloneAsPure

cloneAsPure(): MTextEnt
克隆为纯文本对象（无边框和内边距）创建一个不带边框和内边距的文本副本，用于特殊显示需求

Returns MTextEnt
纯文本对象副本建议重命名为：cloneAsPureText
- Defined in entities/MTextEnt.ts:472

cloneAsDTexts

cloneAsDTexts(): TextEnt[]
克隆为单行文本数组将多行文本分解为多个单行文本对象，每行创建一个独立的文本实体用于将MTEXT转换为多个DTEXT对象

Returns TextEnt[]
单行文本对象数组
- Defined in entities/MTextEnt.ts:484

setRowSpcFac

setRowSpcFac(rowSpacingFactor: number): void
设置行间距因子设置文本行间距的倍数因子，影响多行文本的垂直间距
Parameters
- rowSpacingFactor: number
  行间距因子值建议重命名为：setRowSpacingFactor
Returns void
- Defined in entities/MTextEnt.ts:605

setLineSpacingFactor

setLineSpacingFactor(autocadLineSpacingFactor: number): void
设置行间距因子（AutoCAD兼容格式）根据AutoCAD标准的行间距因子设置内部行间距值
Parameters
- autocadLineSpacingFactor: number
  AutoCAD格式的行间距因子
Returns void
- Defined in entities/MTextEnt.ts:625

getNestEntsAsDText

getNestEntsAsDText(): TextEnt[]
获取嵌套实体作为单行文本返回将多行文本分解为单行文本后的所有实体，包括文本和边框

Returns TextEnt[]
嵌套实体数组（单行文本格式）建议重命名为：getNestedEntitiesAsDTexts
- Defined in entities/MTextEnt.ts:637

getNestEnts

getNestEnts(): MTextEnt[]
获取嵌套实体返回文本对象的所有嵌套实体，包括文本本身和可选的边框

Returns MTextEnt[]
嵌套实体数组建议重命名为：getNestedEntities
- Defined in entities/MTextEnt.ts:647

setRotation

setRotation(angle: number): void
设置旋转角度（方法形式）提供与rotation setter相同的功能，用于API一致性
Parameters
- angle: number
  新的旋转角度（弧度）
Returns void
- Defined in entities/MTextEnt.ts:694

setInnerCornerPoints

setInnerCornerPoints(points: Point2D[]): void
由渲染阶段写回内部四个角点（世界坐标系）如果之前空间索引缓存了宽高为0的边界框，则更新缓存和索引
Parameters
- points: Point2D[]
Returns void
- Defined in entities/MTextEnt.ts:840

getInnerCornerPoints

getInnerCornerPoints(): Point2D[]
获取内部角点坐标获取文本内容区域的四个角点坐标。角点由 WASM 渲染阶段写回，格式为 [左下, 右下, 右上, 左上]（世界坐标）

Returns Point2D[]
内部角点坐标数组
- Defined in entities/MTextEnt.ts:856

boundingBox

boundingBox(coordinateSystemType?: CoordinateSystemType): BoundingBox
计算边界框计算文本在指定坐标系中的边界框。使用 WASM 渲染时写回的角点数据。
Parameters
- coordinateSystemType: CoordinateSystemType = CoordinateSystemType.WCS
  坐标系类型（WCS/UCS/DCS）
Returns BoundingBox
文本边界框
- Defined in entities/MTextEnt.ts:867

setMTextAttachmentByKw

setMTextAttachmentByKw(
attachmentKeyword: string,
updateInsertionPoint?: boolean,
): void
通过关键字设置多行文本附着点使用字符串关键字设置文本的附着位置
Parameters
- attachmentKeyword: string
  附着点关键字（如"TL"、"TC"等）
- updateInsertionPoint: boolean = true
  是否同时更新插入点位置建议重命名为：setMTextAttachmentByKeyword
Returns void
- Defined in entities/MTextEnt.ts:895

setTextAttachmentWithMode

setTextAttachmentWithMode(
attachmentType: number,
updateInsertionPoint?: boolean,
): void
设置文本附着点（带模式控制）设置文本附着点，可选择是否同时更新外部插入点
Parameters
- attachmentType: number
  文本附着点枚举值
- updateInsertionPoint: boolean = true
  是否更新外部插入点位置
Returns void
- Defined in entities/MTextEnt.ts:908

getMTextAttachmentKw

getMTextAttachmentKw(): string
获取多行文本附着点关键字将数字形式的附着点转换为字符串关键字

Returns string
附着点关键字（TL/TC/TR/ML/M/MR/BL/BC/BR）建议重命名为：getMTextAttachmentKeyword
- Defined in entities/MTextEnt.ts:1011

getMTextAttachmentNumberByKw

getMTextAttachmentNumberByKw(keyword: string): number
通过关键字获取多行文本附着点数字将字符串关键字转换为数字形式的附着点枚举值
Parameters
- keyword: string
  附着点关键字
Returns number
附着点数字值建议重命名为：getMTextAttachmentNumberByKeyword
- Defined in entities/MTextEnt.ts:1042

setMTextAlignByKw

setMTextAlignByKw(alignmentKeyword: string): void
通过关键字设置多行文本对齐方式使用字符串关键字设置文本的对齐方式
Parameters
- alignmentKeyword: string
  对齐方式关键字建议重命名为：setMTextAlignByKeyword
Returns void
- Defined in entities/MTextEnt.ts:1077

allPointsWithInBox

allPointsWithInBox(boundingBox: BoundingBox): boolean
检查所有点是否在指定边界框内检查文本的插入点是否在给定的边界框内
Parameters
- boundingBox: BoundingBox
  边界框
Returns boolean
是否在边界框内
- Defined in entities/MTextEnt.ts:1199

mirror

mirror(mirrorAxisStart: PointInput, mirrorAxisEnd: PointInput): void
镜像变换对文本进行镜像变换，这是一个复杂的操作，需要根据不同的附着点类型和镜像轴的角度来调整文本的位置和旋转角度
Parameters
- mirrorAxisStart: PointInput
  镜像轴起点
- mirrorAxisEnd: PointInput
  镜像轴终点
  
  镜像变换算法说明：
  
  计算镜像轴的角度
  
  将文本移动到原点并反向旋转
  
  计算镜像后的角度
  
  根据文本附着点类型和角度范围调整位置和旋转
  
  恢复原始变换
Returns void
Overrides EntityBase.mirror
- Defined in entities/MTextEnt.ts:1217

move

move(fromPoint: PointInput, toPoint: PointInput): void
移动变换将文本从一个位置移动到另一个位置
Parameters
- fromPoint: PointInput
  起始位置
- toPoint: PointInput
  目标位置
Returns void
- Defined in entities/MTextEnt.ts:1303

rotate

rotate(centerPoint: PointInput, angle: number): void
旋转变换围绕指定点旋转文本
Parameters
- centerPoint: PointInput
  旋转中心点
- angle: number
  旋转角度（弧度）
Returns void
- Defined in entities/MTextEnt.ts:1330

scale

scale(centerPoint: PointInput, scaleFactor: number): void
缩放变换以指定点为中心缩放文本
Parameters
- centerPoint: PointInput
  缩放中心点
- scaleFactor: number
  缩放因子
Returns void
- Defined in entities/MTextEnt.ts:1348

stretch

stretch(
    fromPoint: PointInput,
    toPoint: PointInput,
    stretchBox: { pt1: Point2D; pt2: Point2D },
): void
拉伸变换在指定的拉伸框内拉伸文本
Parameters
- fromPoint: PointInput
  拉伸起始点
- toPoint: PointInput
  拉伸目标点
- stretchBox: { pt1: Point2D; pt2: Point2D }
  拉伸框对象，包含pt1和pt2属性
Returns void
- Defined in entities/MTextEnt.ts:1372

repairStretch

repairStretch(backupText: MTextEnt): void
修复拉伸从备份对象恢复拉伸前的插入点位置
Parameters
- backupText: MTextEnt
  备份的文本对象
Returns void
- Defined in entities/MTextEnt.ts:1393

gripEdit

gripEdit(newPosition: Point2D, gripType: string): void
夹点编辑功能通过拖拽夹点来编辑文本的位置和大小
Parameters
- newPosition: Point2D
  新的夹点位置
- gripType: string
  夹点类型标识符
  
  夹点类型说明：
  
  "ins": 插入点夹点，用于移动文本
  
  "opt1"-"opt9": 外边界的9个选项点，用于调整文本框大小建议重命名为：editByGrip
Returns void
- Defined in entities/MTextEnt.ts:1410

getBoundsUcs

getBoundsUcs(): BoundingBox
获取UCS坐标系边界获取文本在用户坐标系中的边界框

Returns BoundingBox
UCS坐标系边界框建议重命名为：getBoundsInUcs
- Defined in entities/MTextEnt.ts:1528

getBounds

getBounds(coordinateSystem?: string): BoundingBox
获取边界框根据指定的坐标系类型获取文本的边界框
Parameters
- coordinateSystem: string = "Ucs"
  坐标系类型，默认为"Ucs"
Returns BoundingBox
指定坐标系中的边界框
- Defined in entities/MTextEnt.ts:1538

undoMap

undoMap(backupText: MTextEnt): void
撤销映射从备份对象恢复文本的所有属性
Parameters
- backupText: MTextEnt
  备份的文本对象
Returns void
- Defined in entities/MTextEnt.ts:1578

clone

clone(): MTextEnt
克隆文本对象创建当前文本对象的完整副本

Returns MTextEnt
克隆的文本对象
- Defined in entities/MTextEnt.ts:1599

toDb

toDb(): DbMText
转换为数据库对象将文本对象转换为可存储到数据库的格式

Returns DbMText
数据库文本对象
- Defined in entities/MTextEnt.ts:1643

fromDb

fromDb(dbText: DbMText): void
从数据库对象加载从数据库对象恢复文本的所有属性
Parameters
- dbText: DbMText
  数据库文本对象
Returns void
- Defined in entities/MTextEnt.ts:1694

dispose

dispose(): void
释放实体占用的外部资源子类如持有 PIXI 对象或大尺寸缓冲，应覆盖此方法清理

Returns void
Overrides EntityBase.dispose
- Defined in entities/MTextEnt.ts:1759

Class MTextEnt

Example

Hierarchy (View Summary)

Index

Constructors

Properties

Accessors

Methods

Constructors

constructor

Parameters

Returns MTextEnt

Properties

objectId

id

_lineType

_isAlive

isDirty

Optionalblock

type

textStyle

Accessors

color

Returns number

Parameters

Returns void

layerId

Returns string

Parameters

Returns void

lineTypeScale

Returns number

Parameters

Returns void

lineWeight

Returns number

Parameters

Returns void

transpMgr

Returns TransparencyManager

Parameters

Returns void

xdataRaw

Returns Record<string, string>

Parameters

Returns void

extData

Returns Record<string, any>

Example

extDataAppName

Returns string

doc

Returns any

layer

Returns string

Parameters

Returns void

lineType

Returns string

Parameters

Returns void

styleName

Returns string

Parameters

Returns void

isAlive

Returns boolean

Parameters

Returns void

insertionPoint

Returns Point2D

Parameters

Returns void

font

Returns string

Parameters

Returns void

rowSpcFac

Returns number

Parameters

`Optional`block