HotXLS Docs

TXLSFormatSnapshot 类

Unit: 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;

请参阅