YStudio Y++

对象类

Y++ / YStudio 开发文档 · 一点滴

类对象支持库(不是扁平命令)。路径:支持库 → 扩展类库 → 对象类。

类型名必须写完整「对象类」。声明时自动创建,一般无需再调 创建*。

硬约束

  1. 类型名必须写「对象类」。COM 自动化(Excel/Word/Shell 等 IDispatch)。
  2. 调用 返回文本;取子对象用 取对象 返回对象类。
  3. 方法调用必须带括号。

快速开始

对象类 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;也可用属性读。

易错对照

错误 正确
类型写成「对象」 必须「对象类」
调用当取对象 子对象用取对象;标量/文本用调用或取/置

相关

Excel类 · DLL