XDrxAPI 35 个 TEXT 函数帮助手册
1函数名称: xdrx-text->mtext
描述:
该函数将AutoCAD单行文本(TEXT)转换为多行文本(MTEXT)实体，支持批量转换。
调用格式:
(xdrx-text->mtext <文本实体或选择集>)
参数说明:
* <文本实体或选择集>: 要转换的文本实体或包含文本的选择集
返回值:
总是返回RSRSLT(AutoCAD结果码)
示例用法1:
(xdrx-text->mtext (car (entsel)))
返回: 将选择的单个文本转换为多行文本
示例用法2:
(xdrx-text->mtext (ssget "X" '((0 . "TEXT"))))
返回: 将图中所有文本批量转换为多行文本
注意事项:
1. 支持单个实体或选择集输入
2. 自动处理嵌套在块中的文本
3. 保留原文本的内容和属性
4. 转换后的多行文本保持原位置
------------------------------------------------------------
2
函数名称: xdrx-text-adjustalignment
描述:
该函数调整AutoCAD文本(TEXT)实体的对齐方式，支持常驻和非常驻内存实体。
调用格式:
(xdrx-text-adjustalignment <文本实体>)
参数说明:
* <文本实体>: 要调整对齐方式的文本实体(支持常驻/非常驻内存实体)
返回值:
成功时返回T，失败返回nil
示例用法:
(xdrx-text-adjustalignment (car (entsel)))
返回: 调整选中文本的对齐方式
注意事项:
1. 支持单个文本实体输入(包括非常驻内存实体)
2. 自动处理文本的当前对齐设置
3. 修改后的文本保持原位置
4. 支持嵌套在块中的文本实体
------------------------------------------------------------
3
函数名称: xdrx-text-alignmentpoint
描述:
该函数获取AutoCAD文本(TEXT)实体的对齐点坐标，支持常驻和非常驻内存实体。
调用格式:
(xdrx-text-alignmentpoint <文本实体>)
参数说明:
* <文本实体>: 要获取对齐点的文本实体(支持常驻/非常驻内存实体)
返回值:
返回文本对齐点的WCS坐标(三维点表)
示例用法:
(xdrx-text-alignmentpoint (car (entsel)))
返回: (x y z) - 选中文本的对齐点坐标
注意事项:
1. 支持单个文本实体输入(包括非常驻内存实体)
2. 返回WCS坐标系下的坐标
3. 支持嵌套在块中的文本实体
4. 2013年6月16日由highflybird修改实现
------------------------------------------------------------
4
函数名称: xdrx-text-box
描述:
该函数获取AutoCAD文本(TEXT/MTEXT)实体的边界框坐标，支持常驻和非常驻内存实体。
调用格式:
(xdrx-text-box <文本实体> )
参数说明:
* <文本实体>: 要获取边界框的文本或MText实体
* : 可选参数，指定时返回相对坐标(默认返回绝对坐标)
返回值:
返回文本边界框的四个角点坐标表(按逆时针顺序)
示例用法1:
(xdrx-text-box (car (entsel)))
返回: ((x1 y1 z1) (x2 y2 z2) (x3 y3 z3) (x4 y4 z4)) - 绝对坐标
示例用法2:
(xdrx-text-box (car (entsel)) T)
返回: ((x1 y1 z1) (x2 y2 z2) (x3 y3 z3) (x4 y4 z4)) - 相对坐标
注意事项:
1. 支持TEXT和MTEXT两种类型
2. 支持常驻/非常驻内存实体
3. 返回点表顺序为逆时针方向
4. 支持嵌套在块中的文本实体
------------------------------------------------------------
5
函数名称: xdrx-text-explode
描述:
该函数将AutoCAD文本(TEXT)分解为几何图形，支持三种分解模式。
调用格式:
(xdrx-text-explode <文本实体> [模式])
参数说明:
* <文本实体>: 要分解的文本实体
* [模式]: 可选参数(0=默认分解为多段线,1=分解为线段,2=返回顶点坐标)
返回值:
根据模式返回不同结果：
- 模式0: 返回新创建的多段线实体
- 模式1: 返回分解后的线段实体
- 模式2: 返回顶点坐标列表
示例用法1:
(xdrx-text-explode (car (entsel)))
返回: 将文本分解为多段线
示例用法2:
(xdrx-text-explode (car (entsel)) 1)
返回: 将文本完全分解为线段
示例用法3:
(xdrx-text-explode (car (entsel)) 2)
返回: 文本轮廓的顶点坐标列表
注意事项:
1. 支持TTF和SHX字体
2. 原文本实体将被删除
3. 支持常驻/非常驻内存实体
4. 模式2返回的坐标已考虑文本变换矩阵
------------------------------------------------------------
5
函数名称: xdrx-text-explode
描述:
该函数将AutoCAD文本(TEXT)分解为几何图形，支持三种分解模式。
调用格式:
(xdrx-text-explode <文本实体> [模式])
参数说明:
* <文本实体>: 要分解的文本实体
* [模式]: 可选参数(0=默认分解为多段线,1=分解为线段,2=返回顶点坐标)
返回值:
根据模式返回不同结果：
- 模式0: 返回新创建的多段线实体
- 模式1: 返回分解后的线段实体
- 模式2: 返回顶点坐标列表
示例用法1:
(xdrx-text-explode (car (entsel)))
返回: 将文本分解为多段线
示例用法2:
(xdrx-text-explode (car (entsel)) 1)
返回: 将文本完全分解为线段
示例用法3:
(xdrx-text-explode (car (entsel)) 2)
返回: 文本轮廓的顶点坐标列表
注意事项:
1. 支持TTF和SHX字体
2. 原文本实体将被删除
3. 支持常驻/非常驻内存实体
4. 模式2返回的坐标已考虑文本变换矩阵
------------------------------------------------------------
6
函数名称: xdrx-text-getproperty
描述:
该函数获取AutoCAD文本(TEXT)实体的所有属性，支持常驻和非常驻内存实体。
调用格式:
(xdrx-text-getproperty <文本实体>)
参数说明:
* <文本实体>: 要获取属性的文本实体
返回值:
返回包含文本属性的关联表，结构如下：
(
(Position . 位置坐标)
(String . 文本内容)
(Style . 文字样式名)
(Height . 文字高度)
(WidthFactor . 宽度因子)
(Rotation . 旋转角度)
(Oblique . 倾斜角度)
(Thickness . 厚度)
(AlignPoint . 对齐点坐标)
(VerMode . 垂直对齐模式)
(HozMode . 水平对齐模式)
(IsMirrInX . X镜像标志)
(IsMirrInY . Y镜像标志)
(Normal . 法线向量)
)
示例用法:
(xdrx-text-getproperty (car (entsel)))
返回: 选中文本的完整属性列表
注意事项:
1. 支持常驻/非常驻内存实体
2. 返回属性非常全面
3. 支持嵌套在块中的文本实体
4. 返回值为AutoCAD关联表格式
------------------------------------------------------------
7
函数名称: xdrx-text-height
描述:
该函数获取AutoCAD文本(TEXT)实体的高度属性，支持常驻和非常驻内存实体。
调用格式:
(xdrx-text-height <文本实体>)
参数说明:
* <文本实体>: 要获取高度的文本实体
返回值:
返回文本的高度值(实数)
示例用法:
(xdrx-text-height (car (entsel)))
返回: 选中文本的高度值
注意事项:
1. 支持常驻/非常驻内存实体
2. 返回值为当前图形单位下的高度值
3. 支持嵌套在块中的文本实体
------------------------------------------------------------
8
函数名称: xdrx-text-horzmode
描述:
该函数获取AutoCAD文本(TEXT)实体的水平对齐模式，支持常驻和非常驻内存实体。
调用格式:
(xdrx-text-horzmode <文本实体>)
参数说明:
* <文本实体>: 要获取对齐模式的文本实体
返回值:
返回对齐模式字符串，可能值包括:
"kTextLeft" - 左对齐
"kTextCenter" - 居中
"kTextRight" - 右对齐
"kTextAlign" - 对齐
"kTextMid" - 中间
"kTextFit" - 适配
示例用法:
(xdrx-text-horzmode (car (entsel)))
返回: "kTextCenter" - 表示文本居中对齐
注意事项:
1. 支持常驻/非常驻内存实体
2. 返回值为预定义对齐模式字符串
3. 支持嵌套在块中的文本实体
4. 2013年6月16日由highflybird修改
------------------------------------------------------------
9
函数名称: xdrx-text-isdefalign
描述:
该函数检查AutoCAD文本(TEXT)实体是否使用默认对齐方式，支持常驻和非常驻内存实体。
调用格式:
(xdrx-text-isdefalign <文本实体>)
参数说明:
* <文本实体>: 要检查的文本实体
返回值:
返回T表示使用默认对齐方式，nil表示使用自定义对齐方式
示例用法:
(xdrx-text-isdefalign (car (entsel)))
返回: T - 表示文本使用默认对齐方式
注意事项:
1. 支持常驻/非常驻内存实体
2. 返回值为布尔值(T/nil)
3. 支持嵌套在块中的文本实体
4. 默认对齐方式指创建文本时的初始对齐设置
------------------------------------------------------------
11
函数名称: xdrx-text-ismirroriny
描述:
该函数检查AutoCAD文本(TEXT)实体是否在Y方向镜像，支持常驻和非常驻内存实体。
调用格式:
(xdrx-text-ismirroriny <文本实体>)
参数说明:
* <文本实体>: 要检查的文本实体
返回值:
返回T表示文本在Y方向镜像，nil表示未镜像
示例用法:
(xdrx-text-ismirroriny (car (entsel)))
返回: T - 表示文本在Y方向镜像
注意事项:
1. 支持常驻/非常驻内存实体
2. 返回值为布尔值(T/nil)
3. 支持嵌套在块中的文本实体
4. Y方向镜像会使文本上下翻转
5. 可与xdrx-text-ismirrorinx配合使用检查双向镜像
------------------------------------------------------------
12
函数名称: xdrx-text-make
描述:
该函数创建新的AutoCAD文本(TEXT)实体，支持多种参数组合方式。
调用格式:
(xdrx-text-make [位置] <文本内容> [文字样式] [高度] [旋转角度])
参数说明:
* [位置]: 可选，文本插入点(3D点或2D点，默认原点)
* <文本内容>: 必需，文本字符串
* [文字样式]: 可选，文字样式名
* [高度]: 可选，文本高度
* [旋转角度]: 可选，文本旋转角度(弧度)
返回值:
返回新创建的文本实体名
示例用法1:
(xdrx-text-make "Hello World")
返回: 在原点创建默认样式的文本
示例用法2:
(xdrx-text-make '(10 20) "测试文本" "Standard" 2.5 0.0)
返回: 在(10,20)处创建指定样式的文本
注意事项:
1. 支持多种参数组合方式
2. 位置参数可以是2D或3D点
3. 高度和角度参数可选
4. 支持内存实体创建
5. 自动使用当前UCS的Z轴方向
------------------------------------------------------------
13
函数名称: xdrx-text-normal
描述:
该函数获取AutoCAD文本(TEXT)实体的法线向量，支持常驻和非常驻内存实体。
调用格式:
(xdrx-text-normal <文本实体>)
参数说明:
* <文本实体>: 要获取法线向量的文本实体
返回值:
返回文本的法线向量(3D点格式)
示例用法:
(xdrx-text-normal (car (entsel)))
返回: (0.0 0.0 1.0) - 表示法线向量为Z轴方向
注意事项:
1. 支持常驻/非常驻内存实体
2. 返回值为3D向量
3. 支持嵌套在块中的文本实体
4. 法线向量决定文本的朝向
5. 默认法线通常为(0,0,1)表示平行于XY平面
------------------------------------------------------------
14
函数名称: xdrx-text-oblique
描述:
该函数获取AutoCAD文本(TEXT)实体的倾斜角度，支持常驻和非常驻内存实体。
调用格式:
(xdrx-text-oblique <文本实体>)
参数说明:
* <文本实体>: 要获取倾斜角度的文本实体
返回值:
返回文本的倾斜角度值(实数，弧度制)
示例用法:
(xdrx-text-oblique (car (entsel)))
返回: 0.5236 - 表示文本倾斜角度为30度(约0.5236弧度)
注意事项:
1. 支持常驻/非常驻内存实体
2. 返回值为弧度值
3. 支持嵌套在块中的文本实体
4. 倾斜角度影响文本的斜体效果
5. 0表示无倾斜，正值向右倾斜，负值向左倾斜
------------------------------------------------------------
15
函数名称: xdrx-text-position
描述:
该函数获取AutoCAD文本(TEXT)实体的位置坐标，支持常驻和非常驻内存实体。
调用格式:
(xdrx-text-position <文本实体>)
参数说明:
* <文本实体>: 要获取位置坐标的文本实体
返回值:
返回文本的位置坐标(3D点)
示例用法:
(xdrx-text-position (car (entsel)))
返回: (10.0 20.0 0.0) - 表示文本位于(10,20,0)坐标点
注意事项:
1. 支持常驻/非常驻内存实体
2. 返回值为3D坐标点
3. 支持嵌套在块中的文本实体
4. 位置坐标是文本的插入点或对齐点
5. 坐标值基于当前UCS坐标系
------------------------------------------------------------
16
函数名称: xdrx-text-setalignpoint
描述:
该函数设置AutoCAD文本(TEXT)实体的对齐点，支持常驻和非常驻内存实体。
调用格式:
(xdrx-text-setalignpoint <文本实体> <对齐点>)
参数说明:
* <文本实体>: 要设置对齐点的文本实体
* <对齐点>: 新的对齐点坐标(3D点)
返回值:
设置成功返回T，失败返回nil
示例用法:
(xdrx-text-setalignpoint (car (entsel)) '(10 20 0))
返回: T - 表示成功设置对齐点为(10,20,0)
注意事项:
1. 支持常驻/非常驻内存实体
2. 对齐点必须是有效的3D点
3. 支持嵌套在块中的文本实体
4. 对齐点影响文本的定位方式
5. 修改对齐点可能改变文本显示位置
------------------------------------------------------------
17
函数名称: xdrx-text-setheight
函数名称：xdrx-text-settextheight
描述:
该函数设置AutoCAD文本(TEXT)实体的高度，支持常驻和非常驻内存实体。
调用格式:
(xdrx-text-setheight <文本实体> <高度值>)
参数说明:
* <文本实体>: 要设置高度的文本实体
* <高度值>: 新的文本高度(整数或实数)
返回值:
设置成功返回T，失败返回nil
示例用法:
(xdrx-text-setheight (car (entsel)) 2.5)
返回: T - 表示成功设置文本高度为2.5
注意事项:
1. 支持常驻/非常驻内存实体
2. 高度值可以是整数或实数
3. 高度值必须大于0
4. 支持嵌套在块中的文本实体
5. 修改高度会影响文本显示大小
------------------------------------------------------------
18
函数名称: xdrx-text-sethozmode
描述:
该函数设置AutoCAD文本(TEXT)实体的水平对齐模式，支持6种对齐方式。
调用格式:
(xdrx-text-sethozmode <文本实体> <对齐模式>)
参数说明:
* <文本实体>: 要设置对齐模式的文本实体
* <对齐模式>: 整数0-5，表示不同对齐方式：
0=左对齐1=居中2=右对齐
3=对齐4=中间5=拟合
返回值:
设置成功返回T，失败返回nil
示例用法:
(xdrx-text-sethozmode (car (entsel)) 1)
返回: T - 表示成功设置文本水平居中对齐
注意事项:
1. 支持6种水平对齐模式(0-5)
2. 模式3和5会同时设置垂直对齐为基线
3. 修改对齐模式会影响文本位置
4. 支持嵌套在块中的文本实体
5. 对齐模式改变后可能需要调整文本位置
------------------------------------------------------------
19
函数名称: xdrx-text-setmirrorinx
描述:
该函数设置AutoCAD文本(TEXT)实体在X方向的镜像状态，支持常驻和非常驻内存实体。
调用格式:
(xdrx-text-setmirrorinx <文本实体> )
参数说明:
* <文本实体>: 要设置镜像状态的文本实体
* : 可选，T表示启用X方向镜像，nil表示禁用(默认nil)
返回值:
设置成功返回T，失败返回nil
示例用法1:
(xdrx-text-setmirrorinx (car (entsel)) T)
返回: T - 表示成功启用文本X方向镜像
示例用法2:
(xdrx-text-setmirrorinx (car (entsel)))
返回: T - 表示成功禁用文本X方向镜像
注意事项:
1. 支持常驻/非常驻内存实体
2. 参数T启用镜像，nil或省略则禁用
3. X方向镜像会使文本左右翻转
4. 支持嵌套在块中的文本实体
5. 可与xdrx-text-setmirroriny配合使用
------------------------------------------------------------
20
函数名称: xdrx-text-setmirroriny
描述:
该函数设置AutoCAD文本(TEXT)实体在Y方向的镜像状态，支持常驻和非常驻内存实体。
调用格式:
(xdrx-text-setmirroriny <文本实体> )
参数说明:
* <文本实体>: 要设置镜像状态的文本实体
* : 可选，T表示启用Y方向镜像，nil表示禁用(默认nil)
返回值:
设置成功返回T，失败返回nil
示例用法1:
(xdrx-text-setmirroriny (car (entsel)) T)
返回: T - 表示成功启用文本Y方向镜像
示例用法2:
(xdrx-text-setmirroriny (car (entsel)))
返回: T - 表示成功禁用文本Y方向镜像
注意事项:
1. 支持常驻/非常驻内存实体
2. 参数T启用镜像，nil或省略则禁用
3. Y方向镜像会使文本上下翻转
4. 支持嵌套在块中的文本实体
5. 可与xdrx-text-setmirrorinx配合使用
------------------------------------------------------------
21
函数名称: xdrx-text-setnormal
描述:
该函数设置AutoCAD文本(TEXT)实体的法线向量，支持常驻和非常驻内存实体。
调用格式:
(xdrx-text-setnormal <文本实体> <法线向量>)
参数说明:
* <文本实体>: 要设置法线向量的文本实体
* <法线向量>: 新的法线向量(3D点格式)
返回值:
设置成功返回T，失败返回nil
示例用法:
(xdrx-text-setnormal (car (entsel)) '(0 0 1))
返回: T - 表示成功设置法线向量为Z轴方向
注意事项:
1. 支持常驻/非常驻内存实体
2. 法线向量会被自动归一化
3. 法线向量决定文本的朝向
4. 支持嵌套在块中的文本实体
5. 默认法线通常为(0,0,1)表示平行于XY平面
------------------------------------------------------------
22
函数名称: xdrx-text-setoblique
描述:
该函数设置AutoCAD文本(TEXT)实体的倾斜角度，支持常驻和非常驻内存实体。
调用格式:
(xdrx-text-setoblique <文本实体> <倾斜角度>)
参数说明:
* <文本实体>: 要设置倾斜角度的文本实体
* <倾斜角度>: 新的倾斜角度(整数或实数，弧度制)
返回值:
设置成功返回T，失败返回nil
示例用法:
(xdrx-text-setoblique (car (entsel)) 0.5236)
返回: T - 表示成功设置文本倾斜角度为30度(约0.5236弧度)
注意事项:
1. 支持常驻/非常驻内存实体
2. 倾斜角度可以是整数或实数
3. 0表示无倾斜，正值向右倾斜，负值向左倾斜
4. 支持嵌套在块中的文本实体
5. 倾斜角度影响文本的斜体效果
------------------------------------------------------------
23
函数名称: xdrx-text-setposition
描述:
该函数设置AutoCAD文本(TEXT)实体的位置点，支持常驻和非常驻内存实体。
调用格式:
(xdrx-text-setposition <文本实体> <位置点>)
参数说明:
* <文本实体>: 要设置位置的文本实体
* <位置点>: 新的位置坐标(3D点格式)
返回值:
设置成功返回T，失败返回nil
示例用法:
(xdrx-text-setposition (car (entsel)) '(100 50 0))
返回: T - 表示成功设置文本位置为(100,50,0)
注意事项:
1. 支持常驻/非常驻内存实体
2. 位置参数必须是3D点坐标
3. 修改位置会影响文本显示位置
4. 支持嵌套在块中的文本实体
5. 位置点与对齐点共同决定文本最终位置
------------------------------------------------------------
24
函数名称: xdrx-text-setproperty
描述:
该函数批量设置AutoCAD文本(TEXT)实体的多种属性，支持常驻和非常驻内存实体。
调用格式:
(xdrx-text-setproperty <文本实体> <属性1> <值1> <属性2> <值2>...)
参数说明:
* <文本实体>: 要设置属性的文本实体
* 支持的属性-值对:
"Height" - 文本高度(正数)
"WidthFactor" - 宽度因子(正数)
"Rotation" - 旋转角度(弧度)
"Oblique" - 倾斜角度(弧度)
"Normal" - 法线向量(3D点)
"MirrorInX" - X镜像(T/nil)
"MirrorInY" - Y镜像(T/nil)
"Position" - 位置点(3D点)
"String" - 文本内容(字符串)
"Thickness" - 厚度(正数)
"VerMode" - 垂直对齐模式(0-3)
"HozMode" - 水平对齐模式(0-5)
"Style" - 文字样式名(字符串)
"AlignPoint" - 对齐点(3D点)
返回值:
设置成功返回T，失败返回nil
示例用法:
(xdrx-text-setproperty (car (entsel)) "Height" 2.5 "Rotation" 0.7854 "String" "新文本")
返回: T - 表示成功设置高度、旋转角度和文本内容
注意事项:
1. 支持常驻/非常驻内存实体
2. 可同时设置多个属性
3. 属性名区分大小写
4. 支持嵌套在块中的文本实体
5. 各属性值需符合相应类型要求
------------------------------------------------------------
25
函数名称: xdrx-text-setrotation
描述:
该函数设置AutoCAD文本(TEXT)实体的旋转角度，支持常驻和非常驻内存实体。
调用格式:
(xdrx-text-setrotation <文本实体> <旋转角度>)
参数说明:
* <文本实体>: 要设置旋转角度的文本实体
* <旋转角度>: 新的旋转角度(整数或实数，弧度制)
返回值:
设置成功返回T，失败返回nil
示例用法:
(xdrx-text-setrotation (car (entsel)) 0.7854)
返回: T - 表示成功设置文本旋转角度为45度(约0.7854弧度)
注意事项:
1. 支持常驻/非常驻内存实体
2. 旋转角度可以是整数或实数
3. 0表示水平方向，正值逆时针旋转
4. 支持嵌套在块中的文本实体
5. 旋转角度会影响文本显示方向
------------------------------------------------------------
26
函数名称: xdrx-text-settextstring
描述:
该函数设置AutoCAD文本(TEXT)实体的字符串内容，支持常驻和非常驻内存实体。
调用格式:
(xdrx-text-settextstring <文本实体> <字符串内容>)
参数说明:
* <文本实体>: 要设置内容的文本实体
* <字符串内容>: 新的文本内容(字符串)
返回值:
设置成功返回T，失败返回nil
示例用法:
(xdrx-text-settextstring (car (entsel)) "新的文本内容")
返回: T - 表示成功更新文本内容
注意事项:
1. 支持常驻/非常驻内存实体
2. 字符串内容需用双引号括起
3. 修改内容会立即更新文本显示
4. 支持嵌套在块中的文本实体
5. 特殊字符需正确转义
------------------------------------------------------------
27
函数名称: xdrx-text-settextstyle
描述:
该函数设置AutoCAD文本(TEXT)实体的文字样式，支持常驻和非常驻内存实体。
调用格式:
(xdrx-text-settextstyle <文本实体> <文字样式名>)
参数说明:
* <文本实体>: 要设置样式的文本实体
* <文字样式名>: 已定义的文字样式名称(字符串)
返回值:
设置成功返回T，失败返回nil
示例用法:
(xdrx-text-settextstyle (car (entsel)) "工程字")
返回: T - 表示成功设置文本样式为"工程字"
注意事项:
1. 支持常驻/非常驻内存实体
2. 文字样式必须已定义
3. 修改样式会影响文本字体和格式
4. 支持嵌套在块中的文本实体
5. 样式名称区分大小写
------------------------------------------------------------
28
函数名称: xdrx-text-setthickness
描述:
该函数设置AutoCAD文本(TEXT)实体的厚度，支持常驻和非常驻内存实体。
调用格式:
(xdrx-text-setthickness <文本实体> <厚度值>)
参数说明:
* <文本实体>: 要设置厚度的文本实体
* <厚度值>: 新的厚度值(整数或实数)
返回值:
设置成功返回T，失败返回nil
示例用法:
(xdrx-text-setthickness (car (entsel)) 0.5)
返回: T - 表示成功设置文本厚度为0.5
注意事项:
1. 支持常驻/非常驻内存实体
2. 厚度值可以是整数或实数
3. 厚度影响文本的3D效果
4. 支持嵌套在块中的文本实体
5. 厚度为0表示无厚度
------------------------------------------------------------
29
函数名称: xdrx-text-setvermode
描述:
该函数设置AutoCAD文本(TEXT)实体的垂直对齐模式，支持常驻和非常驻内存实体。
调用格式:
(xdrx-text-setvermode <文本实体> <对齐模式>)
参数说明:
* <文本实体>: 要设置对齐模式的文本实体
* <对齐模式>: 垂直对齐模式值(0-3):
0 = 基线对齐
1 = 底部对齐
2 = 中间对齐
3 = 顶部对齐
返回值:
设置成功返回T，失败返回nil
示例用法:
(xdrx-text-setvermode (car (entsel)) 2)
返回: T - 表示成功设置文本为垂直居中对齐
注意事项:
1. 支持常驻/非常驻内存实体
2. 模式值必须在0-3范围内
3. 修改对齐模式会影响文本位置
4. 支持嵌套在块中的文本实体
5. 与水平对齐模式配合使用
------------------------------------------------------------
30
函数名称: xdrx-text-setwidthfactor
描述:
该函数设置AutoCAD文本(TEXT)实体的宽度因子，支持常驻和非常驻内存实体。
调用格式:
(xdrx-text-setwidthfactor <文本实体> <宽度因子>)
参数说明:
* <文本实体>: 要设置宽度因子的文本实体
* <宽度因子>: 新的宽度因子值(整数或实数)
返回值:
设置成功返回T，失败返回nil
示例用法:
(xdrx-text-setwidthfactor (car (entsel)) 0.8)
返回: T - 表示成功设置文本宽度因子为0.8(变窄)
注意事项:
1. 支持常驻/非常驻内存实体
2. 宽度因子可以是整数或实数
3. 1.0表示正常宽度，<1.0变窄，>1.0变宽
4. 支持嵌套在块中的文本实体
5. 宽度因子影响文本显示比例
------------------------------------------------------------
31
函数名称: xdrx-text-string
描述:
该函数获取AutoCAD文本(TEXT)实体的字符串内容，支持常驻和非常驻内存实体。
调用格式:
(xdrx-text-string <文本实体>)
参数说明:
* <文本实体>: 要获取内容的文本实体
返回值:
返回文本内容的字符串
示例用法:
(xdrx-text-string (car (entsel)))
返回: "示例文本" - 获取到的文本内容
注意事项:
1. 支持常驻/非常驻内存实体
2. 只读操作，不修改实体
3. 返回的字符串需要调用者释放
4. 支持嵌套在块中的文本实体
5. 特殊字符会被正确返回
------------------------------------------------------------
31
函数名称: xdrx-text-string
描述:
该函数获取AutoCAD文本(TEXT)实体的字符串内容，支持常驻和非常驻内存实体。
调用格式:
(xdrx-text-string <文本实体>)
参数说明:
* <文本实体>: 要获取内容的文本实体
返回值:
返回文本内容的字符串
示例用法:
(xdrx-text-string (car (entsel)))
返回: "示例文本" - 获取到的文本内容
注意事项:
1. 支持常驻/非常驻内存实体
2. 只读操作，不修改实体
3. 返回的字符串需要调用者释放
4. 支持嵌套在块中的文本实体
5. 特殊字符会被正确返回
------------------------------------------------------------
32
函数名称: xdrx-text-textstyle
描述:
该函数获取AutoCAD文本(TEXT)实体的文字样式信息，支持常驻和非常驻内存实体。
调用格式:
(xdrx-text-textstyle <文本实体>)
参数说明:
* <文本实体>: 要查询样式信息的文本实体
返回值:
返回包含样式名称和样式实体的列表(样式名称 样式实体)
示例用法:
(xdrx-text-textstyle (car (entsel)))
返回: ("工程字" <图元名: 7ffff706050>) - 样式名称和样式实体
注意事项:
1. 支持常驻/非常驻内存实体
2. 返回列表包含样式名称和样式实体
3. 需要调用者释放返回的列表
4. 支持嵌套在块中的文本实体
5. 样式不存在时返回nil
------------------------------------------------------------
33
函数名称: xdrx-text-thickness
描述:
该函数获取AutoCAD文本(TEXT)实体的厚度值，支持常驻和非常驻内存实体。
调用格式:
(xdrx-text-thickness <文本实体>)
参数说明:
* <文本实体>: 要查询厚度的文本实体
返回值:
返回文本的厚度值(实数)
示例用法:
(xdrx-text-thickness (car (entsel)))
返回: 0.5 - 文本的厚度值
注意事项:
1. 支持常驻/非常驻内存实体
2. 返回值为实数类型
3. 0表示无厚度
4. 支持嵌套在块中的文本实体
5. 厚度影响文本的3D显示效果
------------------------------------------------------------
34
函数名称: xdrx-text-vertmode
描述:
该函数获取AutoCAD文本(TEXT)实体的垂直对齐模式，支持常驻和非常驻内存实体。
调用格式:
(xdrx-text-vertmode <文本实体>)
参数说明:
* <文本实体>: 要查询垂直对齐模式的文本实体
返回值:
返回垂直对齐模式值(整数):
0 = 基线对齐
1 = 底部对齐
2 = 中间对齐
3 = 顶部对齐
示例用法:
(xdrx-text-vertmode (car (entsel)))
返回: 2 - 表示文本为垂直居中对齐
注意事项:
1. 支持常驻/非常驻内存实体
2. 返回值为整数类型
3. 支持嵌套在块中的文本实体
4. 与水平对齐模式配合使用
5. 无效模式返回nil
------------------------------------------------------------
35
函数名称: xdrx-text-widthfactor
描述:
该函数获取AutoCAD文本(TEXT)实体的宽度因子，支持常驻和非常驻内存实体。
调用格式:
(xdrx-text-widthfactor <文本实体>)
参数说明:
* <文本实体>: 要查询宽度因子的文本实体
返回值:
返回宽度因子值(实数)
示例用法:
(xdrx-text-widthfactor (car (entsel)))
返回: 0.8 - 表示文本宽度为正常宽度的80%
注意事项:
1. 支持常驻/非常驻内存实体
2. 返回值为实数类型
3. 1.0表示正常宽度，<1.0变窄，>1.0变宽
4. 支持嵌套在块中的文本实体
5. 宽度因子影响文本显示比例
------------------------------------------------------------
页:
[1]