活字格获取单元格对象并赋值的 JS 方法

作者: luohao 更新: 2024-01-09 分类: 活字格,JS

概述

在活字格中通过 JavaScript 获取单元格位置对象，实现跨页面或动态操作单元格。常用于扫码枪、动态赋值等场景。

示例代码

// 获取命令参数中的单元格公式
var param = this.CommandParam;
var targetCellFormula = param.ScanCode;

// 通过公式获取单元格位置对象
var cellLocation = this.getCellLocation(targetCellFormula);
var cellInfo = JSON.stringify(cellLocation);

// 通过位置信息获取单元格并赋值
Forguncy.Page.getCellByLocation(JSON.parse(cellInfo)).setValue("OK");

关键方法说明

方法说明
this.CommandParam获取命令传入的参数对象
this.getCellLocation(formula)根据单元格公式获取其位置对象
Forguncy.Page.getCellByLocation(loc)通过位置对象获取单元格实例
cell.setValue(value)设置单元格的值
cell.getValue()获取单元格的值

简化写法

// 如果已知单元格名称，可直接操作
Forguncy.Page.getCell("单元格名称").setValue("OK");

// 通过行列索引获取
Forguncy.Page.getCellByLocation({Row: 0, Column: 1}).setValue("OK");

使用场景

  • 扫码枪扫描条码后自动定位到对应单元格
  • 根据配置动态更新指定单元格内容
  • 跨页面传递单元格位置信息
  • 循环处理表格中的单元格

注意事项

  • getCellByLocation 需要传入对象而非 JSON 字符串，使用前需 JSON.parse()
  • 确保目标单元格存在且可编辑，否则会报错
  • getCellLocation 返回的位置对象包含 Row 和 Column 属性

标签：