Eenheid: lxHandle
Een herbruikbare snapshot van de volledige opmaak van een celbereik,
vastgelegd door IXLSRange.CaptureFormat en toegepast met
IXLSRange.ApplyFormat
Beschrijving
TXLSFormatSnapshot bevat de volledige celopmaak
(lettertypen, vullingen, randen, getalnotaties, uitlijning, beveiliging
en rich-text-kleurslots) zoals vastgelegd op een bepaald moment. De
snapshot is onafhankelijk van de werkmap waaruit deze afkomstig is,
zodat deze kan worden toegepast op bereiken in dezelfde of een andere
werkmap. Instanties worden gemaakt door
IXLSRange.CaptureFormat; de aanroeper is eigenaar van het
geretourneerde object en moet het vrijgeven.
Elk kleurattribuut dat rekening houdt met thema en palet wordt opgeslagen als een
TXLSXfRichSlot-record — de opgeloste kleur plus uit welke
rijkere bron die komt — en de slotposities worden geïdentificeerd door
TXLSXfRichSlotID (rsFillFg, rsFillBg,
rsFont, rsTop, rsBottom,
rsLeft, rsRight, rsDiag); de
snapshot groepeert ze in een TXLSXfRichColors-aggregaat, en
TXLSXfRichSlotSet selecteert meerdere slots in een aanroep zodat
een enkele setter de kleuren van vulling, lettertype en rand tegelijk kan aanpassen.
Methoden
procedure ApplyTo(const ARange: IXLSRange) — past
deze snapshot toe op het opgegeven bereik
Voorbeeld
var
Snapshot: TXLSFormatSnapshot;
begin
Snapshot:= Workbook.Sheets[1].Range['A1', 'D1'].CaptureFormat;
Snapshot.ApplyTo(Workbook.Sheets[2].Range['A1', 'D1']);
Snapshot.Free;
end;
Zie ook