HotXLS-dokumentation

klasse TXLSFormatSnapshot

Enhed: lxHandle
Et genanvendeligt snapshot af et celleområdes fulde formatering, fanget med IXLSRange.CaptureFormat og anvendt med IXLSRange.ApplyFormat

Beskrivelse

TXLSFormatSnapshot gemmer det komplette celleformat (skrifttyper, udfyldninger, kanter, talformater, justering, beskyttelse og rich-text-farvepladser), fanget på et givet tidspunkt. Snapshottet er uafhængigt af den projektmappe, det kom fra, så det kan anvendes på områder i samme eller en anden projektmappe. Instanserne oprettes af IXLSRange.CaptureFormat; kalderen ejer det returnerede objekt og skal selv frigøre det.
Hver tema- og paletbevidst farveattribut gemmes som en TXLSXfRichSlot-post — den opløste farve plus oplysningen, hvilken rigere kilde den kom fra — og pladserne identificeres via TXLSXfRichSlotID (rsFillFg, rsFillBg, rsFont, rsTop, rsBottom, rsLeft, rsRight, rsDiag); snapshottet grupperer dem i et TXLSXfRichColors-aggregat, og TXLSXfRichSlotSet vælger flere pladser i ét kald, så en enkelt setter kan omstyle udfyldnings-, skrifttype- og kantfarver samlet.

Metoder

procedure ApplyTo(const ARange: IXLSRange) — anvender dette snapshot på det givne område

Eksempel

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

Se også