Classe TXLSFormatSnapshot - Referência de desenvolvedor HotXLS

Unidade: lxHandle

Um snapshot reutilizável da formatação completa de um intervalo de células, capturado por IXLSRange.CaptureFormat e aplicado com IXLSRange.ApplyFormat

Descrição

TXLSFormatSnapshot contém o formato completo da célula (fontes, preenchimentos, bordas, formatos de número, alinhamento, proteção e slots de cor de rich-text) capturado em um determinado momento. O snapshot é independente da pasta de trabalho de onde veio, portanto pode ser aplicado a intervalos na mesma pasta de trabalho ou em uma diferente. As instâncias são criadas por IXLSRange.CaptureFormat; o chamador é o proprietário do objeto retornado e deve liberá-lo.

Cada atributo de cor sensível a tema e paleta é armazenado como um record TXLSXfRichSlot — a cor resolvida mais a fonte mais rica de onde veio — e as posições dos slots são identificadas por TXLSXfRichSlotID (rsFillFg, rsFillBg, rsFont, rsTop, rsBottom, rsLeft, rsRight, rsDiag); o snapshot os agrupa em um agregado TXLSXfRichColors, e TXLSXfRichSlotSet seleciona vários slots em uma única chamada, de modo que um único setter pode reestilizar as cores de preenchimento, fonte e borda juntas.

Métodos

procedure ApplyTo(const ARange: IXLSRange) — aplica este snapshot ao intervalo fornecido

Exemplo

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

Veja também

Método CaptureFormat
Método ApplyFormat
Interface IXLSRange