# fsys.openXml.xlsx.editor 库模块帮助文档

## fsys.openXml.xlsx.editor 成员列表 <a id="fsys.openXml.xlsx.editor" href="#fsys.openXml.xlsx.editor">&#x23;</a>

普通 .xlsx 固定坐标内容编辑器；不依赖 Office/WPS/.NET，不计算公式，不编辑宏启用/旧格式/签名包。

### fsys.openXml.xlsx.editor.open(path,options) <a id="fsys.openXml.xlsx.editor.open" href="#fsys.openXml.xlsx.editor.open">&#x23;</a>
打开只读源会话；支持普通 .xlsx，拒绝数字签名与工作簿保护；源文件只读锁定，失败 null,err。

## xlsxEditorObject 成员列表 <a id="xlsxEditorObject" href="#xlsxEditorObject">&#x23;</a>

### xlsxEditorObject.close() <a id="xlsxEditorObject.close" href="#xlsxEditorObject.close">&#x23;</a>
丢弃未保存内存修改并关闭源会话。

### xlsxEditorObject.getCell(sheet,ref) <a id="xlsxEditorObject.getCell" href="#xlsxEditorObject.getCell">&#x23;</a>
读取会话视图；返回 ref,row,column,exists,hasValue,value,valueType,formula,hasFormula,hasCachedValue,raw,styleIndex,merge 等；公式 value 仅是保存缓存。

### xlsxEditorObject.getRange(sheet,ref,options) <a id="xlsxEditorObject.getRange" href="#xlsxEditorObject.getRange">&#x23;</a>
读取有限 A1 矩形并返回明确边界与稀疏 cells；includeRows=true 时附加 values/rows，默认 maxMatrixCells=1000000。

### xlsxEditorObject.listSheets() <a id="xlsxEditorObject.listSheets" href="#xlsxEditorObject.listSheets">&#x23;</a>
返回工作表序号、名称、关系、类型和保护状态；chartsheet/dialogsheet 只能列出，不能作为单元格目标。

### xlsxEditorObject.save(outputPath,options) <a id="xlsxEditorObject.save" href="#xlsxEditorObject.save">&#x23;</a>
另存普通 .xlsx；默认不覆盖且拒绝源文件/硬链接别名；内容改变后保留公式、清除全簿缓存、移除 calcChain 并请求打开时重算；成功返回路径,null,report。

### xlsxEditorObject.setCell(sheet,ref,{value=v|formula=f|clear=true},options) <a id="xlsxEditorObject.setCell" href="#xlsxEditorObject.setCell">&#x23;</a>
原子修改单元格；空字符串/0/false 有效，null 不是清除；普通覆盖已有公式需 allowFormulaOverwrite=true；失败不提交。

### xlsxEditorObject.setRange(sheet,ref,values,options) <a id="xlsxEditorObject.setRange" href="#xlsxEditorObject.setRange">&#x23;</a>
严格完整二维矩形；null 跳过；任一校验失败整批不提交；返回实际变化单元格数,null,report。
