Classe TXLSFormatSnapshot - Referência de programador HotXLS

Unidade: lxHandle

Um instantâneo 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 (tipos de letra, preenchimentos, limites, formatos de número, alinhamento, proteção e ranhuras de cor de texto rico) capturado num determinado momento. O instantâneo é independente do livro de onde provém, pelo que pode ser aplicado a intervalos no mesmo livro ou num livro diferente. As instâncias são criadas por IXLSRange.CaptureFormat; o chamador é o proprietário do objeto devolvido e deve libertá-lo.

Cada atributo de cor sensível ao tema e à paleta é guardado como um registo TXLSXfRichSlot — a cor resolvida mais a fonte mais rica de onde provém — e as posições das ranhuras são identificadas por TXLSXfRichSlotID (rsFillFg, rsFillBg, rsFont, rsTop, rsBottom, rsLeft, rsRight, rsDiag); o instantâneo agrupa-as num agregado TXLSXfRichColors, e TXLSXfRichSlotSet seleciona várias ranhuras numa única chamada, de modo a que um único setter possa restilizar em conjunto as cores do preenchimento, do tipo de letra e do contorno.

Métodos

procedure ApplyTo(const ARange: IXLSRange) — aplica este instantâneo ao intervalo indicado

Exemplo

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

Consulte também

Método IXLSRange.CaptureFormat
Método IXLSRange.ApplyFormat
Interface IXLSRange