Dokumentacja HotXLS

Klasa TXLSFormatSnapshot

Unit: lxHandle
Wielokrotnie używalna migawka pełnego formatowania zakresu komórek, przechwycona przez IXLSRange.CaptureFormat i stosowana za pomocą IXLSRange.ApplyFormat

Opis

TXLSFormatSnapshot zawiera kompletny format komórki (czcionki, wypełnienia, obramowania, formaty liczb, wyrównanie, ochronę i sloty kolorów tekstu sformatowanego) przechwycony w danym momencie. Migawka jest niezależna od skoroszytu, z którego pochodzi, więc można ją zastosować do zakresów w tym samym lub innym skoroszycie. Instancje są tworzone przez IXLSRange.CaptureFormat; wywołujący jest właścicielem zwróconego obiektu i musi go zwolnić.
Każdy atrybut koloru uwzględniający motywy i palety jest przechowywany jako rekord TXLSXfRichSlot — rozszyfrowany kolor plus informacja, z jakiego bogatszego źródła pochodzi — a pozycje slotów są identyfikowane przez TXLSXfRichSlotID (rsFillFg, rsFillBg, rsFont, rsTop, rsBottom, rsLeft, rsRight, rsDiag); migawka grupuje je w agregacie TXLSXfRichColors, a TXLSXfRichSlotSet wybiera kilka slotów jednym wywołaniem, dzięki czemu pojedynczy setter może zmienić jednocześnie kolory wypełnienia, czcionki i obramowania.

Metody

procedure ApplyTo(const ARange: IXLSRange) — stosuje tę migawkę do podanego zakresu

Przykład

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

Zobacz też