给区域设置默认值

在创建 Excel 文档或报告（如财务文档、销售报告、发票、学生状态报告、表单等）时，通常需要具有带有预填充文本或固定数据的单元格，而不是可用于进一步处理和计算的空或空白单元格。

在这种情况下，默认值会有所帮助，并提供要在计算中显示和使用的值或公式，就像普通单元格值一样。GcExcel 在 IRange 接口中提供了 setDefaultValue 方法，允许您设置单元格的默认值以避免空单元格情况。

默认值具有下面列出的某些特征：

您可以通过默认值设置值和公式。以“=”开头的字符串将被视为公式。
如果单元格为空，则其默认值或默认公式将参与重新计算。
默认值公式调整背后的逻辑与单元格公式相同。
导出 Excel 时，当单元格为空时，GcExcel 会将默认值导出为单元格值。如果默认值为公式，则 GcExcel 将丢弃该公式，仅保留计算结果。
可以通过将 null 设置为默认值来清除默认值。
clear 和 unMerge 方法不影响默认值。默认值是在执行这些方法后填充的。

参考以下示例代码设置单元格的默认值：

// Initialize workbook.
var workbook = new Workbook();

// Open defaultValue.xlsx.
workbook.open("defaultValue.xlsx");
var worksheet = workbook.getActiveSheet();
            
// Set default value for standard reduction.
worksheet.getRange("C4:C8").setDefaultValue("=B4 - B4*0.12");

// Set normal value for specific percent reduction.
worksheet.getRange("C6").setFormula("=B6 - B6*0.08");
worksheet.getRange("C8").setFormula("=B8 - B8*0.05");

// Calculate total on default value and specific values.
worksheet.getRange("C9").setFormula("=SUM(C4:C8)");

// Save to an Excel file.
workbook.save("DefaultValueOutput.xlsx");

限制

不能为整行或整列设置默认值。
当默认值设置为公式时，不支持动态数组。因此，默认值的公式引用动态数组时，会自动获取动最左上角的单元格值。
不能复制默认值。