类对象支持库(不是扁平命令)。路径:支持库 → 扩展类库 → 对象类。
类型名必须写完整「对象类」。声明时自动创建,一般无需再调 创建*。
硬约束
- 类型名必须写「对象类」。COM 自动化(Excel/Word/Shell 等 IDispatch)。
调用返回文本;取子对象用取对象返回对象类。- 方法调用必须带括号。
快速开始
对象类 excel
如果 (excel.创建("Excel.Application")) {
excel.置("Visible", 真)
对象类 wb = excel.取对象("Workbooks").调用("Add")
}
对象类/创建
共 1 条。
创建对象
- 签名:
通用 创建对象() - 说明:创建一个 COM 对象包装。一般直接写「对象类 excel」即可(声明时自动创建);「创建对象()」仅在需要显式赋值时使用。
对象类/属性
共 2 条。
错误信息
- 签名:
文本 错误信息 - 说明:最近一次失败原因(无括号属性读)。
是否有效
- 签名:
逻辑 是否有效 - 说明:是否持有有效 COM 对象(无括号属性读)。
对象类/方法
共 20 条。
创建
- 签名:
逻辑 创建(文本 ProgID) - 说明:按 ProgID 创建 COM 对象(CoCreateInstance)。成功返回真。
- 参数一│文本 ProgID: 如 Excel.Application、Word.Application、WScript.Shell。
连接
- 签名:
逻辑 连接(文本 ProgID) - 说明:连接到已运行的 COM 对象(GetActiveObject)。成功返回真。
- 参数一│文本 ProgID: 与 创建 相同。
调用
- 签名:
文本 调用(文本 路径, ...) - 说明:按点号路径调用方法/带参属性,返回文本(VARIANT 转字符串)。最多 10 个可变参数。
- 参数一│文本 路径: 如 Workbooks.Add、Quit。
调用逻辑
- 签名:
文本 调用逻辑(文本 路径, 逻辑 值) - 说明:对路径调用并传入一个逻辑参数,返回文本。
- 参数一│文本 路径
- 参数二│逻辑 值
调用整数
- 签名:
文本 调用整数(文本 路径, 整数 值) - 说明:对路径调用并传入一个整数参数,返回文本。
- 参数一│文本 路径
- 参数二│整数 值
取属性
- 签名:
文本 取属性(文本 路径) - 说明:读取点号路径上的属性,返回文本。
- 参数一│文本 路径: 如 Visible、ActiveWorkbook.Name。
设置属性
- 签名:
逻辑 设置属性(文本 路径, 值) - 说明:设置点号路径上的属性。值可为文本/整数/逻辑。成功返回真。
- 参数一│文本 路径
- 参数二│值: 文本、整数或逻辑。
取对象
- 签名:
通用 取对象(文本 路径, ...) - 说明:按路径取子对象(返回对象类)。可带参数(如 Range,”A1”)。最多 10 个可变参数。
- 参数一│文本 路径
查看
- 签名:
无 查看() - 说明:弹出 Win32 对话框,列出 ITypeInfo 成员与示例。
设置可见
- 签名:
逻辑 设置可见(逻辑 可见) - 说明:设置 Visible 属性。
- 参数一│逻辑 可见
设置显示警告
- 签名:
逻辑 设置显示警告(逻辑 显示) - 说明:设置 DisplayAlerts(Excel/Word)。
- 参数一│逻辑 显示
保存
- 签名:
逻辑 保存() - 说明:保存当前活动工作簿/文档。
另存为
- 签名:
逻辑 另存为(文本 路径) - 说明:另存为指定路径。
- 参数一│文本 路径
关闭文档
- 签名:
逻辑 关闭文档([逻辑 保存变更=假]) - 说明:关闭活动工作簿/文档。
- 参数一│[逻辑 保存变更=假]
智能保存
- 签名:
逻辑 智能保存([文本 路径=""]) - 说明:有路径则另存为,否则保存。
- 参数一│[文本 路径]: 省略或空则 Save。
取当前文件路径
- 签名:
文本 取当前文件路径() - 说明:取活动工作簿/文档的 FullName(或 Path)。
退出
- 签名:
无 退出() - 说明:尝试 Quit 并释放会话。
释放
- 签名:
无 释放() - 说明:释放 COM 引用(不调用 Quit)。
错误信息
- 签名:
文本 错误信息() - 说明:最近一次失败原因;也可用属性读 excel.错误信息。
是否有效
- 签名:
逻辑 是否有效() - 说明:当前是否持有有效 IDispatch;也可用属性读。
易错对照
| 错误 | 正确 |
|---|---|
| 类型写成「对象」 | 必须「对象类」 |
| 调用当取对象 | 子对象用取对象;标量/文本用调用或取/置 |