Třída TXLSFormatSnapshot - Vývojářská reference HotXLS

Jednotka: lxHandle

Znovupoužitelný snímek úplného formátování oblasti buněk, zachycený pomocí IXLSRange.CaptureFormat a aplikovaný pomocí IXLSRange.ApplyFormat

Popis

TXLSFormatSnapshot obsahuje úplný formát buňky (písma, výplně, ohraničení, formáty čísel, zarovnání, ochranu a sloty barev formátovaného textu) zachycený v určitém okamžiku. Snímek je nezávislý na sešitu, ze kterého pochází, takže jej lze aplikovat na oblasti ve stejném nebo jiném sešitu. Instance vytváří IXLSRange.CaptureFormat; volající vlastní vrácený objekt a musí jej uvolnit

Každý atribut barev vnímající motiv i paletu je uložen jako záznam TXLSXfRichSlot — vyřešená barva plus informace, ze kterého bohatšího zdroje pochází — a pozice slotů identifikuje TXLSXfRichSlotID (rsFillFg, rsFillBg, rsFont, rsTop, rsBottom, rsLeft, rsRight, rsDiag); snímek je seskupuje do agregátu TXLSXfRichColors a TXLSXfRichSlotSet vybere několik slotů jedním voláním, takže jediný setter může přestylovat barvy výplně, písma a ohraničení dohromady.

Metody

procedure ApplyTo(const ARange: IXLSRange) — aplikuje tento snímek na zadanou oblast

Příklad

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

Viz také

Metoda CaptureFormat
Metoda ApplyFormat
Rozhraní IXLSRange