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;