YStudio Y++

Excel类:新建工作簿、多表、单元格样式、区域读写与保存

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


slug: s2-04-excel title: Excel类:新建工作簿、多表、单元格样式、区域读写与保存 summary: 覆盖新建/打开/保存/另存为、置取单元格与数字、工作表增删改名、置区域、字体色边框合并、行列宽高;无需安装 Microsoft Excel。 tags: Excel类,xlsx,工作表,单元格,样式 series: supportlib-s2 series_order: 4 type: tutorial


Excel类:新建工作簿、多表、单元格样式、区域读写与保存

面板:支持库 → 扩展类库 → Excel类。仅 .xlsx,不必装 Microsoft Excel。

硬约束

  1. 类型名必须写「Excel类」。
  2. 行列从 1 起。
  3. 新建后 保存 必须带路径;用完 关闭()。
  4. 失败看 取错误();可用 是否已打开() 判断状态。

窗口:按钮演示 编辑框日志

函数 写日志(文本 s) {
    编辑框日志.文本 = 编辑框日志.文本 + s + 换行符
}

函数 按钮演示.单击(整数 X, 整数 Y) {
    编辑框日志.文本 = ""
    文本 路径 = 取临时目录() + "\\ypp_excel_demo.xlsx"
    Excel类 book
    book.新建()

    // ——— 工作表 ———
    book.置工作表名(1, "名单")
    book.添加工作表("汇总")
    写日志("工作表数=" + 到文本(book.取工作表数()) + " 第1名=" + book.取工作表名(1))

    book.置工作表(1)
    book.置单元格(1, 1, "姓名")
    book.置单元格(1, 2, "分数")
    book.置单元格(2, 1, "张三")
    book.置数字(2, 2, 95)
    book.置单元格(3, 1, "李四")
    book.置数字(3, 2, 88)

    // 样式:表头加粗、色、边框、列宽
    book.置字体(1, 1, "微软雅黑", 12, 真, 假)
    book.置文字色(1, 1, "#FFFFFFFF")
    book.置背景色(1, 1, "#FF2F6FED")
    book.置背景色(1, 2, "#FF2F6FED")
    book.置文字色(1, 2, "#FFFFFFFF")
    book.置边框(1, 1, 1, 2, 1)
    book.置列宽(1, 16)
    book.置列宽(2, 10)
    book.置行高(1, 22)
    book.置对齐(1, 1, 2, 1)  // 水平2=中,垂直1=中

    // 区域读写
    book.置区域(5, 1, "备注区A1:B2")
    写日志("取区域=" + book.取区域(5, 1))

    // 合并示例
    book.置单元格(7, 1, "合并标题")
    book.合并单元格(7, 1, 7, 2)

    // 第二张表写汇总
    book.置工作表(2)
    book.置单元格(1, 1, "人数")
    book.置数字(1, 2, 2)

    如果 (book.保存(路径) == 假) {
        写日志("保存失败:" + book.取错误())
        book.关闭()
        返回 ()
    }
    写日志("已保存 " + 路径 + " 行数=" + 到文本(book.取行数()) + " 列数=" + 到文本(book.取列数()))
    book.关闭()

    // ——— 再打开读回 ———
    如果 (book.打开(路径) == 假) {
        写日志("打开失败:" + book.取错误())
        返回 ()
    }
    book.置工作表(1)
    写日志("读回:" + book.取单元格(2, 1) + " / 分数=" + 到文本(book.取数字(2, 2)))
    // 另存为副本
    文本 副本 = 取临时目录() + "\\ypp_excel_copy.xlsx"
    如果 (book.另存为(副本) == 假) {
        写日志("另存为失败:" + book.取错误())
    } 否则 {
        写日志("另存为 " + 副本)
    }
    book.关闭()
}

对照:Excel类