HotXLS dokumentáció

TXLSFormatSnapshot osztály

Egység: lxHandle
Egy cellatartomány teljes formázásának újrafelhasználható pillanatképe, amelyet az IXLSRange.CaptureFormat rögzít, és az IXLSRange.ApplyFormat alkalmaz

Leírás

A TXLSFormatSnapshot az adott időpontban rögzített teljes cellaformátumot tartalmazza (betűtípusok, kitöltések, szegélyek, számformátumok, igazítás, védelem és gazdag szövegű színhelyek). A pillanatkép független attól a munkafüzettől, amelyből származik, így ugyanazon vagy másik munkafüzet tartományaira is alkalmazható. A példányokat az IXLSRange.CaptureFormat hozza létre; a hívó birtokolja a visszaadott objektumot, és fel kell szabadítania.
Minden téma- és palettaérzékeny színattribútum egy TXLSXfRichSlot rekordként tárolódik — a feloldott szín plusz az a gazdagabb forrás, amelyből származik —, a slotpozíciókat pedig a TXLSXfRichSlotID azonosítja (rsFillFg, rsFillBg, rsFont, rsTop, rsBottom, rsLeft, rsRight, rsDiag); a pillanatkép ezeket egy TXLSXfRichColors összesítőben csoportosítja, a TXLSXfRichSlotSet pedig egyetlen hívásban több slotot jelöl ki, így egyetlen setter egy lépésben tudja átállítani a kitöltés, a betűtípus és a szegély színeit.

Metódusok

procedure ApplyTo(const ARange: IXLSRange) — ezt a pillanatképet alkalmazza a megadott tartományra

Példa

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

Lásd még