HotXLS 文件

TXLSFormatSnapshot 類別

單元: lxHandle
儲存格範圍完整格式的可重複使用快照,由 IXLSRange.CaptureFormat 擷取,並以 IXLSRange.ApplyFormat 套用

描述

TXLSFormatSnapshot 保存在某個時間點所擷取的完整儲存格格式(字型、 填滿、框線、數字格式、對齊、保護及富文字色彩插槽)。快照與其來源活頁簿 無關,因此可套用至相同或不同活頁簿中的範圍。實例由 IXLSRange.CaptureFormat 建立;呼叫端擁有傳回的物件, 且必須將其釋放。
每個支援主題與調色盤的色彩屬性,都會存成一筆 TXLSXfRichSlot 記錄 —— 包含解析後的色彩,以及它來自哪個 較豐富的來源 —— 插槽位置則由 TXLSXfRichSlotID 標識 (rsFillFg、rsFillBg、rsFont、 rsTop、rsBottom、rsLeft、 rsRight、rsDiag);快照把這些插槽集中在 TXLSXfRichColors 聚合裡,而 TXLSXfRichSlotSet 可以一次呼叫選取多個插槽,讓單一 setter 同時改寫填滿、字型與框線色彩。

方法

procedure ApplyTo(const ARange: IXLSRange) — 將 此快照套用至指定的範圍

範例

var
  Snapshot: TXLSFormatSnapshot;
begin
  Snapshot:= Workbook.Sheets[1].Range['A1', 'D1'].CaptureFormat;
  Snapshot.ApplyTo(Workbook.Sheets[2].Range['A1', 'D1']);
  Snapshot.Free;
end;

另請參閱