XDrxAPI 92 个 DOC 相关函数帮助文档
1函数名称: xdrx-doc->arxs
函数别名: xdrx-doc-loadedarxlist
描述:
获取当前加载的ARX应用程序列表
调用格式:
(xdrx-doc->arxs [参数])
参数说明:
* 参数: 可选，任意值存在时返回完整路径
返回值:
返回ARX应用程序列表(字符串列表)，无加载ARX时返回nil
示例用法1:
(xdrx-doc->arxs)
; 返回已加载ARX的基本文件名列表
示例用法2:
(xdrx-doc->arxs T)
; 返回已加载ARX的完整路径列表
注意事项:
1. 无参数时返回简单文件名列表
2. 有参数时返回完整路径列表
3. 结果包含所有已加载的ARX应用程序
4. 可用于检查特定ARX是否已加载
5. 返回顺序与加载顺序相关
------------------------------------------------------------
2
函数名称: xdrx-doc->dlls
描述:
获取当前进程加载的所有DLL模块列表
调用格式:
(xdrx-doc->dlls )
参数说明:
* T: 可选，存在时返回完整路径(T)
返回值:
返回按字母排序的DLL模块列表(字符串列表)
示例用法1:
(xdrx-doc->dlls)
; 返回当前加载DLL的文件名列表
示例用法2:
(xdrx-doc->dlls T)
; 返回当前加载DLL的完整路径列表
注意事项:
1. 无参数时返回简单文件名列表
2. 有T参数时返回完整路径列表
3. 结果按字母顺序排序
4. 包含所有已加载的DLL模块
5. 可用于检查特定DLL是否已加载
------------------------------------------------------------
3
函数名称: xdrx-doc->lastpts
描述:
获取最近使用的两个点坐标
调用格式:
(xdrx-doc->lastpts)
参数说明:
无参数
返回值:
返回包含两个3D点坐标的列表(pt1 pt2)
示例用法:
(xdrx-doc->lastpts)
; 返回类似: ((1.0 2.0 0.0) (3.0 4.0 0.0))
注意事项:
1. 总是返回最近使用的两个点
2. 点坐标格式为3D点(x y z)
3. 第一个点是pt1，第二个点是pt2
4. 可用于获取最近操作的点数据
5. 点坐标基于当前UCS
------------------------------------------------------------
4
函数名称: xdrx-doc->lisps
函数别名: xdrx-doc-loadedlisplist
描述:
获取当前文档加载的LISP文件列表
调用格式:
(xdrx-doc->lisps [参数])
参数说明:
* 参数: 可选，任意值存在时返回完整路径
返回值:
返回LISP文件列表(字符串列表)，无加载LISP时返回nil
示例用法1:
(xdrx-doc->lisps)
; 返回已加载LISP的基本文件名列表
示例用法2:
(xdrx-doc->lisps T)
; 返回已加载LISP的完整路径列表
注意事项:
1. 无参数时返回简单文件名列表
2. 有参数时返回完整路径列表
3. 结果包含当前文档加载的所有LISP文件
4. 可用于检查特定LISP是否已加载
5. 返回顺序与加载顺序相关
------------------------------------------------------------
5
函数名称: xdrx-doc-acadname
描述:
获取AutoCAD产品名称
调用格式:
(xdrx-doc-acadname)
参数说明:
无参数
返回值:
返回AutoCAD产品名称字符串，失败返回nil
示例用法:
(xdrx-doc-acadname)
; 可能返回: "AutoCAD 2026 - English"
注意事项:
1. 从Windows注册表读取产品名称
2. 返回完整的AutoCAD产品名称
3. 可用于检测当前运行的AutoCAD版本
4. 需要注册表读取权限
5. 不同语言版本可能返回本地化名称
------------------------------------------------------------
6
函数名称: xdrx-doc-apifullpath
描述:
获取当前API模块的完整路径
调用格式:
(xdrx-doc-apifullpath)
参数说明:
无参数
返回值:
返回当前API模块的完整路径字符串
示例用法:
(xdrx-doc-apifullpath)
; 返回类似: "C:\\Program Files\\XDSoft\\XDrx.x64.25.arx"
注意事项:
1. 返回当前加载的API模块的完整路径
2. 可用于获取当前运行的XDAPI模块位置
3. 路径包含文件名和扩展名
4. 路径格式为操作系统原生格式
5. 总是返回当前模块的路径
------------------------------------------------------------
7
函数名称: xdrx-doc-apipath
描述:
获取当前API模块所在目录路径
调用格式:
(xdrx-doc-apipath)
参数说明:
无参数
返回值:
返回当前API模块所在目录的完整路径字符串（以反斜杠结尾）
示例用法:
(xdrx-doc-apipath)
; 返回类似: "C:\\Program Files\\XDSoft\\"
注意事项:
1. 返回路径不包含文件名
2. 路径以反斜杠结尾
3. 路径会被缓存，后续调用直接返回缓存结果
4. 可用于获取API模块的安装目录
5. 路径格式为操作系统原生格式
------------------------------------------------------------
8
函数名称: xdrx-doc-ensureview
描述:
调整视图范围确保指定区域可见
调用格式:
(xdrx-doc-ensureview 点1 点2) 或
(xdrx-doc-ensureview 中心点 宽度 高度)
参数说明:
* 点1: 矩形第一个角点(POINT/POINT)
* 点2: 矩形对角点(POINT/POINT)
或
* 中心点: 视图中心点(POINT/POINT)
* 宽度: 视图宽度(REAL/INT)
* 高度: 视图高度(REAL/INT)
返回值:
成功返回T，失败返回nil
示例用法1:
(xdrx-doc-ensureview '(0 0) '(100 100))
; 调整视图显示0,0到100,100区域
示例用法2:
(xdrx-doc-ensureview '(50 50) 200 150)
; 以50,50为中心显示200x150区域
注意事项:
1. 支持两种调用方式
2. 参数可以是实数或整数
3. 点参数可以是2D或3D点
4. 会自动调整到最佳显示比例
5. 失败时返回nil
------------------------------------------------------------
9
函数名称: xdrx-doc-getcurrentcolor
函数别名: xdrx-doc-colors
描述:
获取AutoCAD界面元素的颜色设置
调用格式:
(xdrx-doc-getcurrentcolor)
参数说明:
无参数
返回值:
返回包含界面颜色设置的关联列表，格式为：
'(
("GraphicsBackColor" R G B) ; 图形区背景色
("TextForeColor" R G B) ; 文本前景色
("TextBackColor" R G B) ; 文本背景色
("GraphicsCrossHairColor" R G B) ; 图形区十字光标颜色
("LayoutBackColor" R G B) ; 布局背景色
("LayoutCrossHairColor" R G B) ; 布局十字光标颜色
("AutoTrackingVecColor" R G B) ; 自动追踪矢量颜色
("CmdLineForeColor" R G B) ; 命令行前景色
("CmdLineBackColor" R G B) ; 命令行背景色
)
示例用法:
(xdrx-doc-getcurrentcolor)
; 返回类似:
; (("GraphicsBackColor" 0 0 0) ("TextForeColor" 255 255 255)...)
注意事项:
1. 返回颜色值为RGB分量格式
2. 不同AutoCAD版本返回的颜色项可能不同
3. 颜色值范围0-255
4. 可用于界面颜色分析或备份
5. 无参数调用
------------------------------------------------------------
10
函数名称: xdrx-doc-clearcmdline
描述:
清除AutoCAD命令行内容
调用格式:
(xdrx-doc-clearcmdline)
参数说明:
无参数
返回值:
无返回值
示例用法:
(xdrx-doc-clearcmdline)
; 清除命令行所有内容
注意事项:
1. 无参数调用
2. 无返回值
3. 会立即清除命令行所有内容
4. 不影响命令历史记录
5. 可用于清理命令行界面
------------------------------------------------------------
11
函数名称: xdrx-doc-closeall
描述:
关闭所有打开的AutoCAD文档
调用格式:
(xdrx-doc-closeall)
参数说明:
无参数
返回值:
总是返回nil
示例用法:
(xdrx-doc-closeall)
; 关闭所有打开的文档
注意事项:
1. 无参数调用
2. 总是返回nil
3. 会强制关闭所有打开的文档
4. 不保存未保存的修改
5. 相当于对每个文档执行_.close命令
6. 使用前应确保重要文档已保存
------------------------------------------------------------
12
函数名称: xdrx-doc-closeallother
描述:
关闭除当前文档外的所有AutoCAD文档
调用格式:
(xdrx-doc-closeallother)
参数说明:
无参数
返回值:
总是返回T
示例用法:
(xdrx-doc-closeallother)
; 关闭除当前文档外的所有文档
注意事项:
1. 无参数调用
2. 总是返回T
3. 保留当前活动文档
4. 关闭其他所有打开的文档
5. 不保存未保存的修改
6. 使用前应确保重要文档已保存
------------------------------------------------------------
13
函数名称: xdrx-doc-closecurdoc
描述:
关闭当前活动的AutoCAD文档
调用格式:
(xdrx-doc-closecurdoc)
参数说明:
无参数
返回值:
成功返回T，失败返回nil
示例用法:
(xdrx-doc-closecurdoc)
; 关闭当前活动文档
注意事项:
1. 无参数调用
2. 成功返回T，失败返回nil
3. 仅关闭当前活动文档
4. 不保存未保存的修改
5. 如果当前文档是最后一个文档，AutoCAD可能保持打开状态
6. 使用前应确保文档已保存
------------------------------------------------------------
14
函数名称: xdrx-doc-cmdargs
描述:
获取AutoCAD启动时的命令行参数列表
调用格式:
(xdrx-doc-cmdargs)
参数说明:
无参数
返回值:
返回命令行参数列表，无参数则返回nil
示例用法:
(xdrx-doc-cmdargs)
; 可能返回: ("acad.exe" "/nologo" "/b" "startup.scr")
注意事项:
1. 无参数调用
2. 返回字符串列表或nil
3. 第一个参数通常是AutoCAD可执行文件路径
4. 可用于检测启动配置和脚本
5. 参数顺序与启动时一致
------------------------------------------------------------
15
函数名称: xdrx-doc-cmdline
描述:
获取AutoCAD命令行当前显示的文本内容
调用格式:
(xdrx-doc-cmdline)
参数说明:
无参数
返回值:
返回命令行当前文本内容，获取失败返回nil
示例用法:
(xdrx-doc-cmdline)
; 可能返回: "line 0,0 100,100"
注意事项:
1. 无参数调用
2. 返回当前命令行文本或nil
3. 获取的是命令行界面显示的内容
4. 可能包含未执行的命令
5. 不同于xdrx-doc-cmdargs(获取启动参数)
6. 可用于监控命令行状态
------------------------------------------------------------
16
函数名称: xdrx-doc-custominfo
描述:
管理AutoCAD文档的自定义摘要信息
调用格式:
(xdrx-doc-custominfo ])
参数说明:
* 无参数: 返回所有自定义信息
* nil: 删除所有自定义信息
* key: 获取指定key的值
* key value: 设置指定key的值
* key nil: 删除指定key的值
返回值:
* 获取操作: 返回字符串或nil
* 设置/删除操作: 成功返回T，失败返回nil
* 获取全部: 返回属性列表
示例用法1:
(xdrx-doc-custominfo)
; 返回所有自定义信息
示例用法2:
(xdrx-doc-custominfo "author" "张三")
; 设置author属性为"张三"
示例用法3:
(xdrx-doc-custominfo "author")
; 获取author属性值
注意事项:
1. 支持多种参数形式
2. 键值对存储在文档摘要信息中
3. 信息会随文档保存
4. 可用于存储文档元数据
5. 键名区分大小写
------------------------------------------------------------
17
函数名称: xdrx-doc-date2time
描述:
将Julian日期转换为详细时间分量
调用格式:
(xdrx-doc-date2time )
参数说明:
* julian-date: 可选，Julian日期值(实数)，缺省使用当前系统日期
返回值:
返回包含7个时间分量的列表：(年 月 日 时 分 秒 毫秒)
示例用法1:
(xdrx-doc-date2time)
; 返回当前系统时间分量，如: ("2025" "5" "19" "15" "51" "33" "0")
示例用法2:
(xdrx-doc-date2time 2460488.5)
; 转换指定Julian日期
注意事项:
1. Julian日期是从公元前4713年1月1日中午开始的天数
2. 返回值均为字符串格式
3. 毫秒部分通常为"0"
4. 无参数时使用AutoCAD系统变量DATE
5. 可用于精确时间计算和转换
------------------------------------------------------------
18
函数名称: xdrx-doc-delayedinvoke
描述:
延迟调用指定的LISP回调函数
调用格式:
(xdrx-doc-delayedinvoke 延迟毫秒数 回调函数名)
参数说明:
* 延迟毫秒数: 正整数，延迟执行的时间(毫秒)
* 回调函数名: 字符串，要延迟调用的LISP函数名
返回值:
总是返回T
示例用法:
(xdrx-doc-delayedinvoke 1000 "my-callback")
; 1秒后调用(my-callback)函数
注意事项:
1. 回调函数必须是已定义的LISP函数
2. 延迟时间单位为毫秒(1000毫秒=1秒)
3. 实际延迟可能有微小偏差
4. 回调函数调用时不带参数
5. 适用于需要延迟执行的操作
------------------------------------------------------------
19
函数名称: xdrx-doc-demandload
描述:
管理AutoCAD按需加载配置(ARX模块)
调用格式:
(xdrx-doc-demandload [参数...])
参数说明:
* 无参数: 检查是否设置了启动加载，是则返回T
* nil: 移除按需加载配置
* T: 设置启动加载
* (appname modulename desc ):
- appname: 应用程序名称
- modulename: 模块文件名
- desc: 描述信息
- reason: 可选，加载原因代码(整数)
返回值:
* 配置操作: 成功返回T
* 检查操作: 已配置返回T，否则nil
示例用法1:
(xdrx-doc-demandload)
; 检查启动加载配置
示例用法2:
(xdrx-doc-demandload "XDSoft" "xdrx19.arx" "晓东工具箱")
; 配置按需加载
注意事项:
1. 用于管理ARX模块的按需加载
2. 加载原因代码可使用位组合：
- 1: 启动时加载
- 2: 按请求加载
- 4: 命令调用时加载
3. 模块文件必须能被AutoCAD找到
4. 配置会保存到注册表
------------------------------------------------------------
20
函数名称: xdrx-doc-entmakeretlist
描述:
设置API生成新实体的返回格式
调用格式:
(xdrx-doc-entmakeretlist )
参数说明:
* T: 设置返回实体表格式
* nil: 设置返回选择集格式(默认)
* 无参数: 等同于nil
返回值:
总是返回T
示例用法1:
(xdrx-doc-entmakeretlist T)
; 设置后续API返回实体表
示例用法2:
(xdrx-doc-entmakeretlist nil)
; 恢复默认返回选择集
注意事项:
1. 影响后续API创建实体的返回格式
2. 等同于(xdrx-setvar "EntMakeToList" 1)
3. 实体表格式更便于LISP处理
4. 选择集格式兼容AutoCAD原生行为
------------------------------------------------------------
21
函数名称: xdrx-doc-extractpiafile
描述:
解压PC3打印机配置文件
调用格式:
(xdrx-doc-extractpiafile pc3文件 [输出路径] )
参数说明:
* pc3文件: 要解压的PC3文件路径
* 输出路径: 可选，解压文件输出路径
* T: 可选，尝试压缩(暂未实现)
返回值:
成功返回解压后的文件路径，失败返回nil
示例用法:
(xdrx-doc-extractpiafile "D:/plot/HP.pc3" "D:/output")
; 解压HP.pc3到D:/output目录
注意事项:
1. PC3是AutoCAD打印机配置文件
2. 解压后可查看内部配置
3. 压缩功能暂未实现
4. 需要文件读写权限
------------------------------------------------------------
22
函数名称: xdrx-doc-forcedwgredraw
描述:
强制重绘当前AutoCAD绘图窗口
调用格式:
(xdrx-doc-forcedwgredraw)
参数说明:
无参数
返回值:
总是返回T
示例用法:
(xdrx-doc-forcedwgredraw)
; 强制刷新绘图窗口
注意事项:
1. 无参数调用
2. 立即刷新当前绘图窗口
3. 适用于图形显示异常时强制刷新
4. 比(grtext)更底层直接
5. 不影响实际图形数据
------------------------------------------------------------
23
函数名称: xdrx-doc-funcexecstatus
描述:
获取或打印函数执行状态信息
调用格式:
(xdrx-doc-funcexecstatus )
参数说明:
* 无参数: 返回当前错误状态字符串
* T: 打印当前错误状态到命令行
* 错误码: 返回指定错误码对应的状态字符串
返回值:
* 无参数/错误码: 返回状态字符串
* T参数: 无返回值(打印到命令行)
示例用法1:
(xdrx-doc-funcexecstatus)
; 返回当前错误状态
示例用法2:
(xdrx-doc-funcexecstatus T)
; 打印当前错误状态
注意事项:
1. 用于调试和错误处理
2. 错误码为AutoCAD API错误代码
3. 无参数时返回内核当前错误状态
4. 打印模式直接输出到命令行窗口
------------------------------------------------------------
24
函数名称: xdrx-doc-getclipboard
描述:
获取系统剪贴板中的文本内容
调用格式:
(xdrx-doc-getclipboard)
参数说明:
无参数
返回值:
剪贴板中的文本内容(字符串)，无文本时返回空字符串
示例用法:
(xdrx-doc-getclipboard)
; 返回剪贴板内容如："示例文本"
注意事项:
1. 仅获取文本内容
2. 不支持获取图像等非文本内容
3. 需要系统剪贴板访问权限
4. AutoCAD可能限制剪贴板访问
------------------------------------------------------------
25
函数名称: xdrx-doc-getcmdlinetext
描述:
获取AutoCAD命令行文本内容
调用格式:
(xdrx-doc-getcmdlinetext [长度 | 搜索文本])
参数说明:
* 无参数: 返回完整命令行文本
* 长度(整数): 返回右侧指定长度的文本
* 搜索文本(字符串): 搜索并返回匹配位置前的文本(暂未实现)
返回值:
命令行文本内容(字符串)
示例用法1:
(xdrx-doc-getcmdlinetext)
; 返回完整命令行文本
示例用法2:
(xdrx-doc-getcmdlinetext 10)
; 返回命令行最后10个字符
注意事项:
1. 主要用于获取命令行历史
2. 长度参数最大1024
3. 搜索功能当前未实现
4. 返回内容包含命令提示符
------------------------------------------------------------
26
函数名称: xdrx-doc-getcpoint
描述:
获取当前点坐标值
调用格式:
(xdrx-doc-getcpoint)
参数说明:
无参数
返回值:
当前点坐标(三维点表)，格式：(X Y Z)
示例用法:
(xdrx-doc-getcpoint)
; 返回当前点如：(125.0 300.4 0.0)
注意事项:
1. 返回AutoCAD内部记录的当前点
2. 通常由其他函数设置
3. 可用于获取上一次操作的点坐标
4. Z坐标通常为0(二维情况)
------------------------------------------------------------
27
函数名称: xdrx-doc-getcurrentspace
描述:
获取当前AutoCAD空间名称
调用格式:
(xdrx-doc-getcurrentspace)
参数说明:
无参数
返回值:
当前空间名称字符串，如"Model"或布局名
示例用法:
(xdrx-doc-getcurrentspace)
; 可能返回："Model" 或 "Layout1"
注意事项:
1. 返回模型空间或当前布局名称
2. 模型空间固定返回"Model"
3. 布局空间返回布局标签名称
4. 可用于判断当前绘图环境
------------------------------------------------------------
28
函数名称: xdrx-doc-getmousecoord
描述:
获取鼠标在AutoCAD绘图窗口中的WCS坐标
调用格式:
(xdrx-doc-getmousecoord)
参数说明:
无参数
返回值:
鼠标位置的三维WCS坐标(点表)，格式：(X Y Z)
示例用法:
(xdrx-doc-getmousecoord)
; 返回当前鼠标坐标如：(125.4 300.2 0.0)
注意事项:
1. 返回世界坐标系(WCS)坐标
2. Z坐标通常为0(二维情况)
3. 坐标精度取决于屏幕分辨率
4. 仅当鼠标在绘图窗口内时有效
5. 可用于动态追踪鼠标位置
------------------------------------------------------------
29
函数名称: xdrx-doc-getmousepixel
描述:
获取鼠标在屏幕和AutoCAD窗口中的像素坐标
调用格式:
(xdrx-doc-getmousepixel)
参数说明:
无参数
返回值:
包含两个点的列表：
1. 屏幕坐标(相对于屏幕左上角)
2. AutoCAD窗口客户区坐标(相对于窗口左上角)
示例用法:
(xdrx-doc-getmousepixel)
; 返回如：((1920 1080) (500 300))
注意事项:
1. 第一个点是全局屏幕坐标
2. 第二个点是AutoCAD窗口相对坐标
3. 可用于精确定位鼠标位置
4. 坐标单位为像素
5. 当AutoCAD窗口最小化时可能返回无效值
------------------------------------------------------------
30
函数名称: xdrx-doc-getprec
描述:
获取当前距离和角度捕捉容差设置
调用格式:
(xdrx-doc-getprec)
参数说明:
无参数
返回值:
包含两个值的列表：
1. 距离捕捉容差(单位与绘图一致)
2. 角度捕捉容差(度)
示例用法:
(xdrx-doc-getprec)
; 返回如：(0.5 15.0) 表示0.5单位距离容差和15度角度容差
注意事项:
1. 距离单位与当前绘图单位一致
2. 角度值已转换为度
3. 影响对象捕捉和追踪行为
4. 可用于检查当前精度设置
------------------------------------------------------------
31
函数名称: xdrx-doc-getviewtwist
描述:
获取当前视图的安全扭曲角度和实际扭曲角度
调用格式:
(xdrx-doc-getviewtwist)
参数说明:
无参数
返回值:
包含两个值的列表：
1. 安全扭曲角度(弧度)
2. 实际扭曲角度(弧度)
示例用法:
(xdrx-doc-getviewtwist)
; 返回如：(0.785398 0.785398) 表示π/4弧度的扭曲角度
注意事项:
1. 安全角度是经过调整的可用角度
2. 实际角度是视图的真实扭曲值
3. 角度单位为弧度
4. 影响视图旋转和显示
------------------------------------------------------------
32
函数名称: xdrx-doc-getversionex
描述:
获取当前API版本号
调用格式:
(xdrx-doc-getversionex)
参数说明:
无参数
返回值:
API版本号字符串，格式如："2025.05.18"
示例用法:
(xdrx-doc-getversionex)
; 返回如："2025.05.18"
注意事项:
1. 返回完整的版本号字符串
2. 可用于版本兼容性检查
3. 版本号格式为：主版本.次版本.修订号.构建号
4. 不同版本API可能有功能差异
------------------------------------------------------------
33
函数名称: xdrx-doc-initstatusbar
描述:
初始化或设置状态栏显示内容
调用格式:
(xdrx-doc-initstatusbar 起始位置 "标签文本")
参数说明:
* 起始位置: 状态栏起始位置(整数)
* "标签文本": 要显示的文本内容(字符串)
返回值:
无
示例用法:
(xdrx-doc-initstatusbar 0 "正在处理...")
; 在状态栏位置0显示"正在处理..."
注意事项:
1. 起始位置通常为0开始的索引
2. 标签文本会显示在状态栏指定位置
3. 用于显示程序运行状态
4. 需要配合其他状态栏更新函数使用
------------------------------------------------------------
34
函数名称: xdrx-doc-isacad64
描述:
检测当前AutoCAD是否为64位版本
调用格式:
(xdrx-doc-isacad64)
参数说明:
无参数
返回值:
* T: 当前为64位AutoCAD
* nil: 当前为32位AutoCAD
示例用法:
(xdrx-doc-isacad64)
; 64位AutoCAD返回T，32位返回nil
注意事项:
1. 用于判断AutoCAD运行环境
2. 返回值可直接用于条件判断
3. 与操作系统位数无关，仅检测AutoCAD
------------------------------------------------------------
35
函数名称: xdrx-doc-isentmakeinmemory
描述:
检查当前是否处于内存实体创建模式
调用格式:
(xdrx-doc-isentmakeinmemory)
参数说明:
无参数
返回值:
* T: 当前处于内存实体创建模式
* nil: 当前不在内存实体创建模式
示例用法:
(xdrx-doc-isentmakeinmemory)
; 等同于(xdrx-getvar "EntMakeInMemory")
注意事项:
1. 用于判断当前实体创建模式
2. 与(xdrx-getvar "EntMakeInMemory")功能相同
3. 内存模式下创建的实体不会立即加入数据库
------------------------------------------------------------
36
函数名称: xdrx-doc-ispaperspace
描述:
检查当前是否处于图纸空间(PaperSpace)
调用格式:
(xdrx-doc-ispaperspace)
参数说明:
无参数
返回值:
* T: 当前在图纸空间
* nil: 当前在模型空间
示例用法:
(xdrx-doc-ispaperspace)
; 返回T表示当前在图纸空间
注意事项:
1. 用于判断当前绘图空间类型
2. 图纸空间用于布局和打印
3. 模型空间用于实际绘图
4. 与系统变量TILEMODE相关
------------------------------------------------------------
37
函数名称: xdrx-doc-isptoutscreen
描述:
检查点是否在当前屏幕显示范围外
调用格式:
(xdrx-doc-isptoutscreen 点坐标)
参数说明:
* 点坐标: 要检查的点坐标(2D或3D点表)
返回值:
* T: 点在当前屏幕外
* nil: 点在当前屏幕内
示例用法:
(xdrx-doc-isptoutscreen '(1000 1000))
; 检查点(1000,1000)是否在屏幕外
注意事项:
1. 点坐标可以是2D或3D格式
2. 基于当前视图范围判断
3. 可用于检查点是否可见
4. 与视图缩放比例相关
------------------------------------------------------------
38
函数名称: xdrx-doc-istextscr
描述:
检查AutoCAD文本窗口是否可见
调用格式:
(xdrx-doc-istextscr)
参数说明:
无参数
返回值:
* T: 文本窗口当前可见
* nil: 文本窗口不可见或最小化
示例用法:
(xdrx-doc-istextscr)
; 返回T表示文本窗口可见
注意事项:
1. 文本窗口指AutoCAD命令行窗口
2. 即使窗口被移动出屏幕也会返回nil
3. 可用于判断用户是否能查看命令行输出
------------------------------------------------------------
39
函数名称: xdrx-doc-isvlide
描述:
检查Visual LISP编辑器(VLIDE)窗口是否可见
调用格式:
(xdrx-doc-isvlide)
参数说明:
无参数
返回值:
* T: VLIDE窗口当前可见
* nil: VLIDE窗口不可见或未运行
示例用法:
(xdrx-doc-isvlide)
; 返回T表示VLIDE窗口可见
注意事项:
1. VLIDE是AutoCAD内置的LISP开发环境
2. 仅检测窗口可见性，不检测是否激活
3. 可用于判断用户是否能访问VLIDE
------------------------------------------------------------
40
函数名称: xdrx-doc-iswcs
描述:
检查当前坐标系是否为世界坐标系(WCS)
调用格式:
(xdrx-doc-iswcs)
参数说明:
无参数
返回值:
* T: 当前为世界坐标系(WCS)
* nil: 当前为用户坐标系(UCS)
示例用法:
(xdrx-doc-iswcs)
; 返回T表示当前为WCS
注意事项:
1. WCS是固定不变的全局坐标系
2. UCS是用户自定义的可变坐标系
3. 与系统变量UCSFOLLOW相关
4. 影响坐标转换和对象定位
------------------------------------------------------------
41
函数名称: xdrx-doc-lastpoint
描述:
获取AutoCAD中最后输入的点坐标
调用格式:
(xdrx-doc-lastpoint)
参数说明:
无参数
返回值:
最后输入的点坐标(3D点表)，格式：(X Y Z)
示例用法:
(xdrx-doc-lastpoint)
; 返回如：(100.0 200.0 0.0)
注意事项:
1. 返回的是用户最后输入的点坐标
2. 包含Z坐标，二维情况下Z通常为0
3. 可用于连续绘图操作
4. 与系统变量LASTPOINT类似
------------------------------------------------------------
42
函数名称: xdrx-doc-loadedarxapps
描述:
获取当前加载的所有ARX应用程序列表
调用格式:
(xdrx-doc-loadedarxapps)
参数说明:
无参数
返回值:
已加载的ARX应用程序名称列表，格式：("app1" "app2" ...)
示例用法:
(xdrx-doc-loadedarxapps)
; 返回如：("acad" "acdb" "acge")
注意事项:
1. ARX是AutoCAD的C++扩展应用
2. 返回当前会话中加载的所有ARX应用
3. 可用于检查特定ARX是否已加载
4. 列表顺序无特定意义
------------------------------------------------------------
43
函数名称: xdrx-doc-loadedlispapps
描述:
获取当前加载的所有LISP应用程序列表
调用格式:
(xdrx-doc-loadedlispapps)
参数说明:
无参数
返回值:
已加载的LISP应用程序文件名列表，格式：("file1.lsp" "file2.fas" ...)
示例用法:
(xdrx-doc-loadedlispapps)
; 返回如：("acad.lsp" "utils.fas")
注意事项:
1. 返回当前文档中加载的所有LISP文件
2. 包含.lsp和.fas等LISP格式文件
3. 可用于检查特定LISP是否已加载
4. 列表顺序无特定意义
------------------------------------------------------------
44
函数名称: xdrx-doc-loadlinetype
描述:
从线型定义文件加载线型
调用格式:
(xdrx-doc-loadlinetype [线型名称] )
参数说明:
* 线型名称: 字符串，指定要加载的线型名称（可选）
* T|nil: T表示强制重新加载，nil表示不强制（可选）
返回值:
成功加载的线型列表，格式：(("线型名" <实体名>) ...)
示例用法1:
(xdrx-doc-loadlinetype "DASHED")
; 加载DASHED线型
示例用法2:
(xdrx-doc-loadlinetype "acad.lin" "DASHED" T)
; 从acad.lin强制加载DASHED线型
注意事项:
1. 默认使用acadiso.lin文件
2. 可指定自定义线型文件
3. 返回列表包含线型名和实体名
4. 强制加载会覆盖现有定义
------------------------------------------------------------
45
函数名称: xdrx-doc-lock
描述:
锁定当前AutoCAD文档
调用格式:
(xdrx-doc-lock )
参数说明:
* T: 可选参数，表示独占写锁定
返回值:
总是返回T表示锁定成功
示例用法1:
(xdrx-doc-lock)
; 普通锁定当前文档
示例用法2:
(xdrx-doc-lock T)
; 独占写锁定当前文档
注意事项:
1. 防止其他会话修改文档
2. 独占锁定会阻止其他所有写操作
3. 解锁需要关闭文档或使用xdrx-doc-unlock
------------------------------------------------------------
46
函数名称: xdrx-doc-makeablock
描述:
创建标注块或获取标注样式实体
调用格式:
(xdrx-doc-makeablock [块名])
参数说明:
* 块名: 字符串，指定要创建的块名（可选）
返回值:
创建的块实体名或标注样式实体名
示例用法1:
(xdrx-doc-makeablock)
; 创建所有预定义标注块
示例用法2:
(xdrx-doc-makeablock "DIM1")
; 创建指定标注块或获取标注样式
注意事项:
1. 无参数时创建19种预定义标注块
2. 指定名称时优先创建块，不存在则查找标注样式
3. 支持常见标注块如_Dot、_Closed等
------------------------------------------------------------
47
函数名称: xdrx-doc-pan
描述:
平移当前视图或指定视口
调用格式:
(xdrx-doc-pan 平移向量 [视口实体])
参数说明:
* 平移向量: 2D或3D点，表示平移方向和距离
* 视口实体: 可选，指定要平移的视口实体名
返回值:
总是返回T表示成功
示例用法1:
(xdrx-doc-pan '(100 50))
; 将视图向右平移100，向上平移50
示例用法2:
(xdrx-doc-pan '(100 0) view_ent)
; 将指定视口向右平移100
注意事项:
1. 平移向量为相对坐标
2. 支持模型空间和图纸空间视口
3. 不改变缩放比例
4. 视口参数需为有效视口实体
------------------------------------------------------------
48
函数名称: xdrx-doc-panup
描述:
将当前视图向上平移半个视口高度
调用格式:
(xdrx-doc-panup)
参数说明:
无参数
返回值:
总是返回T表示成功
示例用法:
(xdrx-doc-panup)
; 视图向上平移半个屏幕高度
注意事项:
1. 平移距离为当前视口高度的一半
2. 不改变缩放比例
3. 仅影响当前活动视图
4. 适用于快速浏览长图档
5. 支持透明执行(在其他命令执行过程中调用)
------------------------------------------------------------
49
函数名称: xdrx-doc-panleft
描述:
将当前视图向左平移半个视口宽度
调用格式:
(xdrx-doc-panleft)
参数说明:
无参数
返回值:
总是返回T表示成功
示例用法:
(xdrx-doc-panleft)
; 视图向左平移半个屏幕宽度
注意事项:
1. 平移距离为当前视口宽度的一半
2. 不改变缩放比例
3. 仅影响当前活动视图
4. 适用于快速浏览宽图档
5. 支持透明执行(在其他命令执行过程中调用)
------------------------------------------------------------
50
函数名称: xdrx-doc-panright
描述:
将当前视图向右平移半个视口宽度
调用格式:
(xdrx-doc-panright)
参数说明:
无参数
返回值:
总是返回T表示成功
示例用法:
(xdrx-doc-panright)
; 视图向右平移半个屏幕宽度
注意事项:
1. 平移距离为当前视口宽度的一半
2. 不改变缩放比例
3. 仅影响当前活动视图
4. 适用于快速浏览宽图档
5. 支持透明执行(在其他命令执行过程中调用)
------------------------------------------------------------
51
函数名称: xdrx-doc-pandown
描述:
将当前视图向下平移半个视口高度
调用格式:
(xdrx-doc-pandown)
参数说明:
无参数
返回值:
总是返回T表示成功
示例用法:
(xdrx-doc-pandown)
; 视图向下平移半个屏幕高度
注意事项:
1. 平移距离为当前视口高度的一半
2. 不改变缩放比例
3. 仅影响当前活动视图
4. 适用于快速浏览长图档
5. 支持透明执行(在其他命令执行过程中调用)
------------------------------------------------------------
52
函数名称: xdrx-doc-pixelbox
描述:
获取AutoCAD窗口的像素坐标框(考虑DPI缩放)
调用格式:
(xdrx-doc-pixelbox [窗口类型])
参数说明:
* 窗口类型: 可选整数(默认为0)
0-当前绘图窗口
1-主程序窗口
2-命令行窗口
返回值:
返回包含4个点表的列表，表示窗口四角的像素坐标:
((左下角)(右下角)(右上角)(左上角))
示例用法1:
(xdrx-doc-pixelbox)
; 获取当前绘图窗口的像素坐标框
示例用法2:
(xdrx-doc-pixelbox 1)
; 获取AutoCAD主窗口的像素坐标框
注意事项:
1. 坐标已自动考虑系统DPI缩放
2. 返回值为屏幕绝对坐标
3. 可用于精确定位窗口区域
4. 支持透明执行
------------------------------------------------------------
53
函数名称: xdrx-doc-plot2pdf
描述:
将AutoCAD图纸批量输出为多页PDF文件
调用格式:
(xdrx-doc-plot2pdf PDF文件名 [数据库实体] [布局名称])
参数说明:
* PDF文件名: 输出的PDF文件路径(字符串)
* 数据库实体: 可选，指定数据库实体(默认为当前数据库)
* 布局名称: 可选，指定布局名称(字符串)
返回值:
成功返回PDF文件名，失败返回nil
示例用法1:
(xdrx-doc-plot2pdf "C:/output.pdf")
; 将当前图纸输出为PDF
示例用法2:
(xdrx-doc-plot2pdf "C:/output.pdf db_ent "Layout1")
; 指定数据库和布局输出PDF
注意事项:
1. 支持多页PDF输出
2. 可指定不同数据库和布局
3. 文件路径需包含扩展名.pdf
4. 需要写权限的目标目录
------------------------------------------------------------
54
函数名称: xdrx-doc-purgeall
描述:
清理图形数据库中未使用的对象
调用格式:
(xdrx-doc-purgeall [标志位] [数据库实体])
参数说明:
* 标志位: 可选整数(默认为8388607)，控制清理类型:
1-图层 2-线型 4-文字样式 8-标注样式
16-块 32-视口配置 64-视图 128-UCS
256-视口 512-打印样式 1024-多线样式
2048-表格样式 4096-视觉样式 8192-材质
16384-光源 32768-相机 65536-渲染预设
131072-剖面线 262144-多重引线样式
524288-注释比例 1048576-详细索引样式
2097152-数据提取模板 4194304-所有可清理对象
* 数据库实体: 可选，指定目标数据库(默认为当前数据库)
返回值:
返回清理结果列表(长整型ID数 短整型ID数 空对象数)
示例用法1:
(xdrx-doc-purgeall)
; 清理当前数据库所有可清理对象
示例用法2:
(xdrx-doc-purgeall 3 db_ent)
; 清理指定数据库的图层和线型
注意事项:
1. 默认清理所有可清理对象类型
2. 可组合标志位值(如3=1+2表示清理图层和线型)
3. 返回统计信息可用于分析清理效果
------------------------------------------------------------
55
函数名称: xdrx-doc-recentcmdlist
描述:
获取最近执行的AutoCAD命令列表
调用格式:
(xdrx-doc-recentcmdlist)
参数说明:
无参数
返回值:
返回最近执行的命令名称列表(字符串列表)
示例用法:
(xdrx-doc-recentcmdlist)
; 可能返回: ("LINE" "CIRCLE" "MOVE" "COPY")
注意事项:
1. 返回最近执行的用户命令
2. 自动过滤系统内部命令
3. 列表按执行顺序排列
4. 可用于命令历史分析或重复执行
------------------------------------------------------------
56
函数名称: xdrx-doc-redraw
描述:
重绘图形窗口或指定实体
调用格式:
(xdrx-doc-redraw [实体名|选择集])
参数说明:
* 实体名: 可选，单个要重绘的实体名
* 选择集: 可选，要重绘的选择集
返回值:
总是返回T表示成功
示例用法1:
(xdrx-doc-redraw)
; 重绘整个图形窗口
示例用法2:
(xdrx-doc-redraw ent)
; 重绘指定实体
示例用法3:
(xdrx-doc-redraw ss)
; 重绘选择集中的所有实体
注意事项:
1. 无参数时刷新整个图形窗口
2. 可指定单个实体或选择集
3. 适用于显示刷新不及时的情况
4. 比REGEN命令更轻量级
------------------------------------------------------------
57
函数名称: xdrx-doc-removedemandload
描述:
移除AutoCAD按需加载的应用程序
调用格式:
(xdrx-doc-removedemandload "应用程序名")
参数说明:
* 应用程序名: 字符串，要移除的按需加载程序名称
返回值:
成功返回T，失败返回nil
示例用法:
(xdrx-doc-removedemandload "MyApp.arx")
; 移除MyApp.arx的按需加载
注意事项:
1. 参数必须是已注册的按需加载程序名
2. 需要完整文件名(包括扩展名)
3. 仅移除按需加载注册，不卸载已加载的程序
4. 需要管理员权限
------------------------------------------------------------
58
函数名称: xdrx-doc-safezoom
描述:
智能缩放视图以确保指定对象完全可见
调用格式:
(xdrx-doc-safezoom 对象1 [对象2...])
参数说明:
* 对象: 可以是以下类型:
- 点(WCS坐标)
- 实体名
- 选择集
- 几何曲线对象
返回值:
总是返回T
示例用法1:
(xdrx-doc-safezoom pt1 pt2)
; 缩放使两个点都可见
示例用法2:
(xdrx-doc-safezoom ent)
; 缩放使指定实体完全可见
示例用法3:
(xdrx-doc-safezoom ss)
; 缩放使选择集中所有实体可见
注意事项:
1. 自动计算所有输入对象的边界框
2. 视图会保留5%的边距
3. 支持WCS和UCS坐标自动转换
4. 可混合不同类型参数
------------------------------------------------------------
59
函数名称: xdrx-doc-saveall
描述:
保存所有打开的AutoCAD文档
调用格式:
(xdrx-doc-saveall)
参数说明:
无参数
返回值:
总是返回nil
示例用法:
(xdrx-doc-saveall)
; 保存所有打开的图纸
注意事项:
1. 自动遍历所有打开的文档
2. 使用qsave命令保存
3. 不会弹出保存对话框
4. 适用于批量保存场景
------------------------------------------------------------
60
函数名称: xdrx-doc-selectlinetype
描述:
弹出线型选择对话框并返回用户选择的线型
调用格式:
(xdrx-doc-selectlinetype)
参数说明:
无参数
返回值:
返回用户选择的线型名称字符串，取消选择返回nil
示例用法:
(setq linetype (xdrx-doc-selectlinetype))
; 弹出线型对话框并将选择结果存入变量
注意事项:
1. 会弹出标准AutoCAD线型选择对话框
2. 用户可浏览和选择当前图形中的线型
3. 适用于需要用户交互选择的场景
------------------------------------------------------------
61
函数名称: xdrx-doc-sendcmdstr
函数别名: xdrx-doc-sendstring
描述:
向AutoCAD发送命令字符串执行
调用格式:
(xdrx-doc-sendcmdstr "命令字符串")
参数说明:
* 命令字符串: 要执行的AutoCAD命令字符串
返回值:
成功执行返回T，失败返回nil
示例用法1:
(xdrx-doc-sendcmdstr "_.line 0,0 100,100 ")
; 执行画线命令
示例用法2:
(xdrx-doc-sendcmdstr "_.zoom _e")
; 执行范围缩放命令
注意事项:
1. 命令字符串需包含完整命令语法
2. 会自动聚焦到命令行窗口
3. 支持透明命令执行
4. 字符串需包含必要的空格和符号
------------------------------------------------------------
62
函数名称: xdrx-doc-sendesc
描述:
向AutoCAD发送ESC键命令(取消当前操作)
调用格式:
(xdrx-doc-sendesc)
参数说明:
无参数
返回值:
总是返回T
示例用法:
(xdrx-doc-sendesc)
; 取消当前正在执行的命令
注意事项:
1. 相当于连续按两次ESC键
2. 可中断大多数正在执行的命令
3. 适用于需要程序化取消操作的场景
4. 不会中断LISP程序本身的执行
------------------------------------------------------------
63
函数名称: xdrx-doc-set-entmakeinmemory
描述:
设置实体创建模式（内存或数据库）
调用格式:
(xdrx-doc-set-entmakeinmemory )
参数说明:
* T: 实体创建到内存
* nil: 实体创建到数据库(默认)
返回值:
总是返回T
示例用法1:
(xdrx-doc-set-entmakeinmemory T)
; 设置实体创建到内存
示例用法2:
(xdrx-doc-set-entmakeinmemory nil)
; 设置实体创建到数据库
注意事项:
1. 内存模式创建的实体不会立即显示
2. 等同于(xdrx-setvar "EntMakeToMemory" <0|1>)
3. 无参数调用时默认设为数据库模式
------------------------------------------------------------
64
函数名称: xdrx-doc-setbackcolor
描述:
设置AutoCAD绘图区背景颜色
调用格式:
(xdrx-doc-setbackcolor (R G B))
参数说明:
* (R G B): 包含3个整数的表，表示RGB颜色值(0-255)
返回值:
成功返回T，失败返回nil
示例用法:
(xdrx-doc-setbackcolor '(255 255 255))
; 设置背景色为白色
注意事项:
1. RGB值范围0-255
2. 自动区分模型空间和图纸空间
3. 颜色变化立即生效
4. 需要CAD 2005及以上版本
------------------------------------------------------------
65
函数名称: xdrx-doc-setclipboard
描述:
设置系统剪贴板内容
调用格式:
(xdrx-doc-setclipboard <字符串>)
参数说明:
* <字符串>: 必须参数，要放入剪贴板的文本内容
返回值:
无返回值
示例用法:
(xdrx-doc-setclipboard "复制到剪贴板的内容")
; 将指定文本放入剪贴板
注意事项:
1. 参数必须是字符串类型
2. 会覆盖剪贴板原有内容
3. 适用于需要程序化操作剪贴板的场景
------------------------------------------------------------
66
函数名称: xdrx-doc-setcmdbarfocus
描述:
将焦点设置到AutoCAD命令行窗口
调用格式:
(xdrx-doc-setcmdbarfocus)
参数说明:
无参数
返回值:
成功返回T，失败返回nil
示例用法:
(xdrx-doc-setcmdbarfocus)
; 将焦点切换到命令行窗口
注意事项:
1. 无参数调用
2. 适用于需要自动聚焦命令行的场景
3. 不会中断当前命令执行
------------------------------------------------------------
67
函数名称: xdrx-doc-setcurrentspace
描述:
设置当前工作空间（模型/布局空间）
调用格式:
(xdrx-doc-setcurrentspace [<布局名> | <实体名>])
参数说明:
* <布局名>: 字符串，指定布局名称
* <实体名>: 实体名，指定布局或块表记录
* 无参数: 重置为默认空间
返回值:
成功返回T，失败返回nil
示例用法1:
(xdrx-doc-setcurrentspace "布局1")
; 切换到名为"布局1"的布局空间
示例用法2:
(xdrx-doc-setcurrentspace)
; 重置当前空间
注意事项:
1. 支持模型空间和所有布局空间
2. 参数可以是布局名称字符串或布局实体名
3. 影响后续实体创建位置
------------------------------------------------------------
68
函数名称: xdrx-doc-setcurrentspaceid
描述:
通过ID设置当前工作空间
调用格式:
(xdrx-doc-setcurrentspaceid <块名> | <实体名>)
参数说明:
* <块名>: 字符串，指定块表记录名称
* <实体名>: 实体名，指定块表记录实体
返回值:
返回设置的空间实体名
示例用法1:
(xdrx-doc-setcurrentspaceid "模型空间")
; 设置当前空间为模型空间
示例用法2:
(xdrx-doc-setcurrentspaceid ent)
; 通过实体设置当前空间
注意事项:
1. 参数必须为有效块名或块表记录实体
2. 影响后续实体创建位置
3. 返回设置的空间实体名
------------------------------------------------------------
69
函数名称: xdrx-doc-setdatabase
描述:
设置当前工作数据库
调用格式:
(xdrx-doc-setdatabase <参数>)
参数说明:
* <实体名>: 切换到指定实体所在的数据库
* <数据库指针>: 直接切换到指定数据库
* <数字ID>: 通过数字ID切换到对应数据库
* <DWG文件路径>: 打开指定DWG文件作为当前数据库
* T: 重置为内部数据库
* nil: 创建新的空白数据库
返回值:
返回数据库实体名
示例用法1:
(xdrx-doc-setdatabase "C:/drawing.dwg")
; 打开指定DWG文件作为当前数据库
示例用法2:
(xdrx-doc-setdatabase ent)
; 切换到实体所在的数据库
注意事项:
1. 支持多种参数类型切换数据库
2. 影响后续所有数据库操作
3. 返回数据库实体名可用于后续操作
------------------------------------------------------------
70
函数名称: xdrx-doc-setdwgviewfocus
描述:
将焦点设置到AutoCAD绘图视图窗口
调用格式:
(xdrx-doc-setdwgviewfocus)
参数说明:
无参数
返回值:
成功返回T，失败返回nil
示例用法:
(xdrx-doc-setdwgviewfocus)
; 将焦点切换到绘图视图窗口
注意事项:
1. 无参数调用
2. 适用于需要自动聚焦绘图区域的场景
3. 不会中断当前命令执行
------------------------------------------------------------
71
函数名称: xdrx-doc-putprec
描述:
设置系统的距离和角度容差精度
调用格式:
(xdrx-doc-putprec [<距离容差> <角度容差> ])
参数说明:
* <距离容差>: 实数，设置距离比较容差(默认0.001)
* <角度容差>: 实数，设置角度比较容差(默认0.001度)
* T: 启用强制样条拟合
* nil: 禁用强制样条拟合
返回值:
成功返回T
示例用法1:
(xdrx-doc-putprec 0.01 0.5)
; 设置距离容差0.01，角度容差0.5度
示例用法2:
(xdrx-doc-putprec 0.01 0.5 T)
; 设置容差并启用强制样条拟合
注意事项:
1. 无参数时使用默认值0.001
2. 角度值会自动转换为弧度
3. 影响所有精度相关的几何计算
------------------------------------------------------------
72
函数名称: xdrx-doc-setundo
描述:
控制撤销记录的启用/禁用状态
调用格式:
(xdrx-doc-setundo )
参数说明:
* T: 禁用撤销记录
* 无参数或nil: 启用撤销记录
返回值:
成功返回T
示例用法1:
(xdrx-doc-setundo T)
; 禁用撤销记录
示例用法2:
(xdrx-doc-setundo)
; 启用撤销记录
注意事项:
1. 主要用于批量操作时提高性能
2. 操作完成后应及时恢复撤销记录
3. 不影响已记录的撤销信息
------------------------------------------------------------
73
函数名称: xdrx-doc-slblist
描述:
读取幻灯片库(.slb)文件内容并返回幻灯片名称列表
调用格式:
(xdrx-doc-slblist <文件路径> )
参数说明:
* <文件路径>: 字符串，幻灯片库文件路径(.slb)
* T: 按名称升序排序(默认)
* nil: 按名称降序排序
返回值:
返回幻灯片名称列表，失败返回nil
示例用法1:
(xdrx-doc-slblist "C:/slides/sample.slb")
; 读取指定幻灯片库文件内容
示例用法2:
(xdrx-doc-slblist "C:/slides/sample.slb" nil)
; 读取并按名称降序排列
注意事项:
1. 需要有效的.slb文件路径
2. 默认按名称升序排列
3. 返回结果为字符串列表
------------------------------------------------------------
74
函数名称: xdrx-doc-startapp
描述:
启动外部应用程序
调用格式:
(xdrx-doc-startapp <应用路径> <参数> )
参数说明:
* <应用路径>: 字符串，要启动的应用程序完整路径
* <参数>: 字符串，传递给应用程序的参数
* T: 显示应用程序窗口(默认)
* nil: 隐藏应用程序窗口
返回值:
成功启动返回T，失败返回nil
示例用法1:
(xdrx-doc-startapp "C:/app.exe" "-mode batch")
; 启动应用并传递参数
示例用法2:
(xdrx-doc-startapp "C:/app.exe" "" nil)
; 启动应用并隐藏窗口
注意事项:
1. 需要完整的应用程序路径
2. 参数为空时传空字符串
3. 影响系统进程管理
------------------------------------------------------------
75
函数名称: xdrx-doc-stuffcmdline
描述:
向AutoCAD命令行发送字符串命令
调用格式:
(xdrx-doc-stuffcmdline <命令字符串>)
参数说明:
* <命令字符串>: 要发送到命令行的字符串命令
返回值:
无返回值
示例用法:
(xdrx-doc-stuffcmdline "line 0,0 100,100")
; 发送画线命令到命令行
注意事项:
1. 命令字符串会自动执行(添加换行符)
2. 支持所有AutoCAD命令格式
3. 命令会在当前文档执行
------------------------------------------------------------
76
函数名称: xdrx-doc-summaryinfo
描述:
获取或设置DWG文件的摘要信息
调用格式:
(xdrx-doc-summaryinfo [<项索引> [<值> | nil]])
参数说明:
* 无参数: 返回所有摘要信息列表
* nil: 清空所有摘要信息
* <项索引>: 0-7的整数，指定摘要信息项
* <值>: 字符串，设置指定项的值
* nil: 清空指定项的值
返回值:
查询时返回字符串或列表，设置成功返回T
示例用法1:
(xdrx-doc-summaryinfo)
; 获取所有摘要信息
示例用法2:
(xdrx-doc-summaryinfo 0 "项目名称")
; 设置第0项摘要信息
注意事项:
1. 摘要信息项索引范围为0-7
2. 影响DWG文件属性信息
3. 支持批量操作
------------------------------------------------------------
77
函数名称: xdrx-doc-trapcmdoutput
描述:
捕获AutoCAD命令窗口的输出内容
调用格式:
(xdrx-doc-trapcmdoutput)
参数说明:
无参数
返回值:
返回字符串形式的命令输出内容
示例用法:
(setq output (xdrx-doc-trapcmdoutput))
; 捕获当前命令窗口输出
注意事项:
1. 需要在命令执行后立即调用
2. 返回最近一次命令的输出
3. 可用于自动化脚本
------------------------------------------------------------
78
函数名称: xdrx-doc-ucsoff
描述:
禁用UCS坐标系，使API函数返回WCS坐标点
调用格式:
(xdrx-doc-ucsoff)
参数说明:
无参数
返回值:
返回0表示成功
示例用法:
(xdrx-doc-ucsoff)
; 禁用UCS坐标系
注意事项:
1. 影响后续API函数的坐标返回值
2. 强制使用世界坐标系(WCS)
3. 不会改变当前UCS状态
------------------------------------------------------------
79
函数名称: xdrx-doc-ucson
描述:
启用UCS坐标系，使API函数返回当前UCS坐标点
调用格式:
(xdrx-doc-ucson)
参数说明:
无参数
返回值:
返回1表示成功
示例用法:
(xdrx-doc-ucson)
; 启用UCS坐标系
注意事项:
1. 与xdrx-doc-ucsoff功能相反
2. 影响后续API函数的坐标返回值
3. 使用当前用户坐标系(UCS)
------------------------------------------------------------
80
函数名称: xdrx-doc-unlock
描述:
解锁当前AutoCAD文档
调用格式:
(xdrx-doc-unlock)
参数说明:
无参数
返回值:
成功解锁返回T
示例用法:
(xdrx-doc-unlock)
; 解锁当前文档
注意事项:
1. 解除文档的只读状态
2. 仅影响当前活动文档
3. 需要文档修改权限
------------------------------------------------------------
81
函数名称: xdrx-doc-viewres
描述:
恢复或设置当前视图
调用格式:
(xdrx-doc-viewres <视图名称> )
(xdrx-doc-viewres <视图表记录> )
参数说明:
* <视图名称>: 字符串，指定要恢复的视图名称
* <视图表记录>: 图元名，指定视图表记录
* T: 可选，恢复后删除原视图记录
返回值:
成功返回T，失败返回nil
示例用法1:
(xdrx-doc-viewres "我的视图")
; 恢复指定名称的视图
示例用法2:
(xdrx-doc-viewres ent T)
; 恢复视图并删除原记录
注意事项:
1. 会自动处理关联的UCS坐标系
2. 影响当前视图显示
3. 需要有效的视图名称或记录
------------------------------------------------------------
82
函数名称: xdrx-doc-viewsave
描述:
保存当前视图为视图表记录
调用格式:
(xdrx-doc-viewsave [<视图名称>])
参数说明:
* <视图名称>: 可选字符串，指定保存的视图名称(默认"XDTB_VIEW_TEMP")
返回值:
返回创建的视图表记录图元名
示例用法1:
(xdrx-doc-viewsave)
; 保存当前视图为临时视图
示例用法2:
(xdrx-doc-viewsave "我的视图")
; 保存当前视图并命名
注意事项:
1. 保存视图中心、方向、大小等参数
2. 默认名称会被覆盖
3. 返回的图元名可用于视图恢复
------------------------------------------------------------
83
函数名称: xdrx-doc-viewset
描述:
设置当前视图或指定视口的视图
调用格式:
(xdrx-doc-viewset <视图表记录>)
(xdrx-doc-viewset <视图表记录> <视口图元>)
参数说明:
* <视图表记录>: 视图表记录图元名
* <视口图元>: 可选，指定要设置的视口图元
返回值:
成功返回T，失败返回nil
示例用法1:
(xdrx-doc-viewset view_ent)
; 设置当前视图
示例用法2:
(xdrx-doc-viewset view_ent vport_ent)
; 设置指定视口的视图
注意事项:
1. 会自动更新视口表记录
2. 需要有效的视图表记录
3. 视口参数可选
------------------------------------------------------------
84
函数名称: xdrx-doc-vpoint
描述:
设置三维视点方向(模拟VPOINT命令)
调用格式:
(xdrx-doc-vpoint <方向向量> )
参数说明:
* <方向向量>: 三维点表，表示视点方向向量
* T: 可选，设置后执行范围缩放
返回值:
成功返回T，失败返回nil
示例用法1:
(xdrx-doc-vpoint '(1 1 1))
; 设置视点方向
示例用法2:
(xdrx-doc-vpoint '(0 0 1) T)
; 设置俯视图并缩放
注意事项:
1. 向量表示从目标点指向相机的方向
2. 自动更新当前视图
3. 可选范围缩放功能
------------------------------------------------------------
85
函数名称: xdrx-doc-xrefrepath
描述:
重新指定外部参照的路径
调用格式:
(xdrx-doc-xrefrepath "参照文件名" "新路径")
参数说明:
* "参照文件名": 字符串，要修改的外部参照文件名
* "新路径": 字符串，新的完整路径
返回值:
成功返回T，失败返回nil
示例用法:
(xdrx-doc-xrefrepath "building.dwg" "C:\\projects\\dwg\\")
; 修改外部参照路径
注意事项:
1. 路径需使用双反斜杠或正斜杠
2. 文件名需包含扩展名
3. 路径应为完整路径
------------------------------------------------------------
86
函数名称: xdrx-doc-zoomall
描述:
缩放显示所有图形对象
调用格式:
(xdrx-doc-zoomall [比例])
参数说明:
* 比例: 可选实数，缩放比例(默认1.0)
返回值:
成功返回T
示例用法1:
(xdrx-doc-zoomall)
; 全图显示所有对象
示例用法2:
(xdrx-doc-zoomall 0.8)
; 以80%比例显示全图
注意事项:
1. 比例小于1表示缩小，大于1表示放大
2. 不影响实际图形尺寸
3. 自动计算合适的显示范围
------------------------------------------------------------
87
函数名称: xdrx-doc-zoomcenter
描述:
以指定点为中心进行缩放
调用格式:
(xdrx-doc-zoomcenter <中心点> <高度> [比例])
参数说明:
* <中心点>: 三维点表，缩放中心坐标
* <高度>: 实数，视图高度
* [比例]: 可选实数，缩放比例(默认1.0)
返回值:
成功返回T
示例用法1:
(xdrx-doc-zoomcenter '(100 100 0) 500)
; 以(100,100)为中心，高度500显示
示例用法2:
(xdrx-doc-zoomcenter '(0 0 0) 1000 0.5)
; 以原点为中心，高度1000，50%比例显示
注意事项:
1. 高度值决定视图范围大小
2. 比例小于1表示缩小，大于1表示放大
3. Z坐标通常设为0
------------------------------------------------------------
88
函数名称: xdrx-doc-zoomentities
描述:
缩放显示指定的实体对象
调用格式:
(xdrx-doc-zoomentities <图元1> <图元2>...)
(xdrx-doc-zoomentities <选择集>)
参数说明:
* <图元>: 图元名，要显示的实体
* <选择集>: 选择集对象，包含多个实体
返回值:
成功返回T
示例用法1:
(xdrx-doc-zoomentities ent1 ent2)
; 缩放显示两个实体
示例用法2:
(xdrx-doc-zoomentities ss)
; 缩放显示选择集中的所有实体
注意事项:
1. 支持同时输入多个图元名
2. 支持选择集作为输入
3. 自动计算最佳显示范围
------------------------------------------------------------
89
函数名称: xdrx-doc-zoomextents
描述:
范围缩放显示图形(可指定布局)
调用格式:
(xdrx-doc-zoomextents [比例] [布局对象])
参数说明:
* [比例]: 可选实数，缩放比例(默认1.0)
* [布局对象]: 可选，布局图元名
返回值:
成功返回T
示例用法1:
(xdrx-doc-zoomextents)
; 全图范围缩放
示例用法2:
(xdrx-doc-zoomextents 0.8 layout_ent)
; 以80%比例缩放指定布局
注意事项:
1. 比例小于1表示缩小，大于1表示放大
2. 可针对特定布局进行缩放
3. 自动计算最佳显示范围
------------------------------------------------------------
90
函数名称: xdrx-doc-zoomprevious
描述:
恢复上一次的视图状态
调用格式:
(xdrx-doc-zoomprevious)
返回值:
成功返回T
示例用法:
(xdrx-doc-zoomprevious)
; 恢复前一个视图
注意事项:
1. 可多次调用逐步回溯视图历史
2. 仅保存有限的视图历史记录
3. 不影响实际图形
------------------------------------------------------------
91
函数名称: xdrx-doc-zoomscaled
描述:
按指定比例和类型缩放视图
调用格式:
(xdrx-doc-zoomscaled 比例 [类型])
参数说明:
* 比例: 实数，缩放比例
* [类型]: 整数(0-2)，缩放类型：
0=相对当前比例
1=相对图纸空间单位
2=相对视口比例
返回值:
成功返回T
示例用法1:
(xdrx-doc-zoomscaled 0.5)
; 缩小为当前视图的50%
示例用法2:
(xdrx-doc-zoomscaled 2.0 1)
; 放大为2倍图纸单位
注意事项:
1. 比例>1放大，<1缩小
2. 默认类型为0(相对当前)
3. 不影响实际图形尺寸
------------------------------------------------------------
92
函数名称: xdrx-doc-zoomwindows
描述:
窗口缩放显示指定区域
调用格式:
(xdrx-doc-zoomwindows <点1> <点2> [比例])
参数说明:
* <点1>: 三维点表，窗口第一个角点
* <点2>: 三维点表，窗口对角点
* [比例]: 可选实数，缩放比例(默认1.0)
返回值:
成功返回T
示例用法1:
(xdrx-doc-zoomwindows '(0 0 0) '(100 100 0))
; 缩放显示0,0到100,100区域
示例用法2:
(xdrx-doc-zoomwindows '(50 50 0) '(150 150 0) 0.8)
; 以80%比例显示指定区域
注意事项:
1. 点坐标通常Z值为0
2. 比例>1放大，<1缩小
3. 自动调整视图中心
------------------------------------------------------------
页:
[1]