BiffPaletteSavePolicy 属性
控制经典工作簿在 BIFF8 保存之前是保留其调色板,还是对真彩色进行显式优化
语法
property BiffPaletteSavePolicy: TXLSBiffPaletteSavePolicy;
值
| 值 | 行为 |
|---|---|
xbpsPreserve | 保持每个调色板槽位不变,并保留原有的保存行为 |
xbpsOptimizeTrueColors | 在序列化 BIFF8 工作簿之前构建并应用一个当前调色板计划 |
行为
默认值为 xbpsPreserve,因此升级本库绝不会隐式更改工作簿调色板
优化策略只对目标格式为 xlExcel97 的 SaveAs 操作生效
BIFF5、CSV、文本、HTML、RTF、PDF、XLSX 和 ODS 输出路径均不受影响
优化后的 BIFF8 保存成功后,已应用的调色板会保留在工作簿模型中,因此后续的索引颜色查询和保存都会遵循同一映射
如果在优化之后输出失败或被取消,原始调色板世代和全部 56 个颜色都会被恢复
示例
Workbook.BiffPaletteSavePolicy := xbpsOptimizeTrueColors;
if Workbook.SaveAs('report.xls', xlExcel97) <> 1 then
HandleSaveFailure;