YStudio Y++

Excel类

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

类对象支持库（不是扁平命令）。路径：支持库 → 扩展类库 → Excel类。

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

硬约束

  1. 类型名必须写「Excel类」（或面板允许的兼容名）。
  2. 仅支持.xlsx（OOXML），无需安装 Microsoft Excel。
  3. 行列从 1 起；打开/新建后记得关闭。

快速开始

Excel类 book
// 打开 / 置单元格 / 保存：见下方命令介绍

Excel类/创建

共 1 条。

创建Excel

  • 签名：通用 创建Excel()
  • 说明：Excel 工作簿会话。一般直接写「Excel类 book」，不必先调本命令。

Excel类/方法

共 44 条。

打开

  • 签名：逻辑 打开(文本 路径, [文本 密码=""])
  • 说明：打开已有.xlsx。加密簿须提供密码。失败返回假，可用取错误()查看原因。
  • 参数一│文本 路径:.xlsx 文件路径
  • 参数二│[文本 密码=”“]: 加密簿密码；无密码可省略

新建

  • 签名：逻辑 新建([文本 密码=""])
  • 说明：在内存中新建空工作簿（含 Sheet1）。密码非空则后续保存将加密。
  • 参数一│[文本 密码=”“]: 可选会话密码

关闭

  • 签名：逻辑 关闭()
  • 说明：关闭工作簿（不自动保存）。

是否已打开

  • 签名：逻辑 是否已打开()
  • 说明：当前是否已打开或新建了工作簿。

重置

  • 签名：无 重置()
  • 说明：关闭并清空会话状态。

保存

  • 签名：逻辑 保存([文本 路径=""], [文本 密码=""])
  • 说明：保存工作簿。路径省略时写回打开路径；密码非空则加密保存。
  • 参数一│[文本 路径=”“]: 省略则写回打开路径；新建后必填
  • 参数二│[文本 密码=”“]: 省略则用会话密码；都空则不加密

另存为

  • 签名：逻辑 另存为(文本 路径, [文本 密码=""])
  • 说明：保存到指定路径。
  • 参数一│文本 路径: 目标.xlsx 路径
  • 参数二│[文本 密码=”“]: 可选加密密码

置密码

  • 签名：逻辑 置密码([文本 密码=""])
  • 说明：设置会话密码（空=清除）；下次保存生效。
  • 参数一│[文本 密码=”“]: 新密码；空则清除

是否有密码

  • 签名：逻辑 是否有密码()
  • 说明：当前会话是否已设置密码。

置单元格

  • 签名：逻辑 置单元格(整数 行, 整数 列, 文本 内容)
  • 说明：写入单元格；行/列从 1 起。空文本清除该格。
  • 参数一│整数 行: 从 1 起
  • 参数二│整数 列: 从 1 起（1=A）
  • 参数三│文本 内容: 单元格文本；空则清除

取单元格

  • 签名：文本 取单元格(整数 行, 整数 列)
  • 说明：读取单元格文本；空单元格返回空文本。行/列从 1 起。
  • 参数一│整数 行: 从 1 起
  • 参数二│整数 列: 从 1 起

取行数

  • 签名：整数 取行数()
  • 说明：当前表已用区域最大行号（无数据为 0）。

取列数

  • 签名：整数 取列数()
  • 说明：当前表已用区域最大列号（无数据为 0）。

清空

  • 签名：逻辑 清空()
  • 说明：清空当前活动工作表全部单元格与样式。

置字体

  • 签名：逻辑 置字体(整数 行, 整数 列, [文本 字体名=""], [小数 字号=0], [整数 粗体=-1], [整数 斜体=-1])
  • 说明：设置单元格字体。字号<=0 不改；粗体/斜体 -1不改、0关、1开。
  • 参数一│整数 行
  • 参数二│整数 列
  • 参数三│[文本 字体名=”“]: 如 Microsoft YaHei UI
  • 参数四│[小数 字号=0]: <=0 表示不改
  • 参数五│[整数 粗体=-1]: -1不改 / 0关 / 1开
  • 参数六│[整数 斜体=-1]: -1不改 / 0关 / 1开

置文字色

  • 签名：逻辑 置文字色(整数 行, 整数 列, 文本 颜色)
  • 说明：设置单元格文字颜色；颜色如 #FF0000；空文本清除。
  • 参数一│整数 行
  • 参数二│整数 列
  • 参数三│文本 颜色: #RRGGBB 或 RRGGBB；空=清除

置背景色

  • 签名：逻辑 置背景色(整数 行, 整数 列, 文本 颜色)
  • 说明：设置单元格纯色背景；空文本清除。
  • 参数一│整数 行
  • 参数二│整数 列
  • 参数三│文本 颜色: #RRGGBB；空=清除

置背景渐变

  • 签名：逻辑 置背景渐变(整数 行, 整数 列, 文本 颜色1, 文本 颜色2, [整数 方向=1])
  • 说明：设置两色渐变背景。方向：1=垂直，2=水平；传 0 清除渐变。
  • 参数一│整数 行
  • 参数二│整数 列
  • 参数三│文本 颜色1
  • 参数四│文本 颜色2
  • 参数五│[整数 方向=1]: 1垂直 / 2水平 / 0清除渐变

清除样式

  • 签名：逻辑 清除样式(整数 行, 整数 列)
  • 说明：清除指定单元格的字体/颜色/填充样式（不影响文本）。
  • 参数一│整数 行
  • 参数二│整数 列

取工作表数

  • 签名：整数 取工作表数()
  • 说明：工作簿中的工作表个数。

取工作表名

  • 签名：文本 取工作表名([整数 索引=0])
  • 说明：取工作表名称；索引省略或<=0 表示当前活动表。
  • 参数一│[整数 索引=0]: 1 起；<=0=当前活动表

置工作表

  • 签名：逻辑 置工作表(整数 索引)
  • 说明：切换活动工作表；可传 1 起索引，或表名。
  • 参数一│整数 索引 或 文本 名称

置工作表名

  • 签名：逻辑 置工作表名(文本 名称, [整数 索引=0])
  • 说明：重命名工作表；索引省略或<=0 表示当前活动表。
  • 参数一│文本 名称: 新表名
  • 参数二│[整数 索引=0]: 1 起；<=0=当前活动表

添加工作表

  • 签名：逻辑 添加工作表([文本 名称=""])
  • 说明：追加一张工作表并切换为活动表；名称省略则自动 SheetN。
  • 参数一│[文本 名称=”“]: 省略则自动命名

删除工作表

  • 签名：逻辑 删除工作表([整数 索引=0])
  • 说明：删除工作表；至少保留一张。索引省略或<=0 表示当前活动表。
  • 参数一│[整数 索引=0]: 1 起；<=0=当前活动表

复制工作表

  • 签名：逻辑 复制工作表([整数 源索引=0], [文本 新名称=""])
  • 说明：复制工作表到末尾并激活。新名称省略则自动「原名 (2)」。
  • 参数一│[整数 源索引=0]: <=0=当前表
  • 参数二│[文本 新名称=”“]

移动工作表

  • 签名：逻辑 移动工作表(整数 从索引, 整数 到索引)
  • 说明：移动工作表位置；索引均从 1 起。
  • 参数一│整数 从索引
  • 参数二│整数 到索引

置区域

  • 签名：逻辑 置区域(整数 行, 整数 列, 文本 内容)
  • 说明：从起点写入矩形区域；列用 Tab 分隔，行用换行分隔（同 Excel 粘贴）。
  • 参数一│整数 行
  • 参数二│整数 列
  • 参数三│文本 内容: TSV 文本块

取区域

  • 签名：文本 取区域(整数 行1, 整数 列1, 整数 行2, 整数 列2)
  • 说明：读取闭区间区域为 TSV 文本。
  • 参数一│整数 行1
  • 参数二│整数 列1
  • 参数三│整数 行2
  • 参数四│整数 列2

置数字

  • 签名：逻辑 置数字(整数 行, 整数 列, 小数 值)
  • 说明：写入数值（Excel 数字，可运算）；可用 置数字格式 控制显示。
  • 参数一│整数 行
  • 参数二│整数 列
  • 参数三│小数 值

取数字

  • 签名：小数 取数字(整数 行, 整数 列)
  • 说明：读取数值；非数字格返回 0。
  • 参数一│整数 行
  • 参数二│整数 列

置日期

  • 签名：逻辑 置日期(整数 行, 整数 列, 文本 日期)
  • 说明：写入日期；支持 yyyy-mm-dd 或 yyyy-mm-dd HH:mm[:ss]。
  • 参数一│整数 行
  • 参数二│整数 列
  • 参数三│文本 日期

取日期

  • 签名：文本 取日期(整数 行, 整数 列)
  • 说明：读取日期文本；非日期/数字格返回空。
  • 参数一│整数 行
  • 参数二│整数 列

置数字格式

  • 签名：逻辑 置数字格式(整数 行, 整数 列, 文本 格式)
  • 说明：设置显示格式，如 0.00 / #,##0.00 / yyyy-mm-dd / 0%；空=常规。
  • 参数一│整数 行
  • 参数二│整数 列
  • 参数三│文本 格式

合并单元格

  • 签名：逻辑 合并单元格(整数 行1, 整数 列1, 整数 行2, 整数 列2)
  • 说明：合并闭区间；至少两格。
  • 参数一│整数 行1
  • 参数二│整数 列1
  • 参数三│整数 行2
  • 参数四│整数 列2

取消合并

  • 签名：逻辑 取消合并(整数 行, 整数 列)
  • 说明：取消包含该格的合并区。
  • 参数一│整数 行
  • 参数二│整数 列

置对齐

  • 签名：逻辑 置对齐(整数 行, 整数 列, [整数 水平=0], [整数 垂直=0], [整数 换行=-1])
  • 说明：水平：0常规/1左/2中/3右；垂直：0下/1中/2上；换行：-1不改/0关/1开。
  • 参数一│整数 行
  • 参数二│整数 列
  • 参数三│[整数 水平=0]
  • 参数四│[整数 垂直=0]
  • 参数五│[整数 换行=-1]

置边框

  • 签名：逻辑 置边框(整数 行1, 整数 列1, 整数 行2, 整数 列2, [整数 样式=1], [文本 颜色=""], [整数 边=15])
  • 说明：对区域设边框。样式：0无/1细/2中/3粗/4虚线；边=15 画外框。
  • 参数一│整数 行1
  • 参数二│整数 列1
  • 参数三│整数 行2
  • 参数四│整数 列2
  • 参数五│[整数 样式=1]
  • 参数六│[文本 颜色=”“]
  • 参数七│[整数 边=15]: 1左 2右 4上 8下

置列宽

  • 签名：逻辑 置列宽(整数 列, 小数 宽度)
  • 说明：设置列宽（Excel 字符宽度单位）。
  • 参数一│整数 列
  • 参数二│小数 宽度

置行高

  • 签名：逻辑 置行高(整数 行, 小数 高度)
  • 说明：设置行高（磅）。
  • 参数一│整数 行
  • 参数二│小数 高度

取列宽

  • 签名：小数 取列宽(整数 列)
  • 说明：取列宽；未设置时默认约 8.43。
  • 参数一│整数 列

取行高

  • 签名：小数 取行高(整数 行)
  • 说明：取行高；未设置时默认 15。
  • 参数一│整数 行

取路径

  • 签名：文本 取路径()
  • 说明：取最近打开/保存的路径；新建未保存则为空。

取错误

  • 签名：文本 取错误()
  • 说明：取最近一次失败原因；成功操作后一般为空。

易错对照

错误 正确
行列从 0 与 Excel 一致从 1
用旧.xls 本类仅.xlsx

相关

对象类 · CSV支持库