單元: 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;
另請參閱