HotXLS-dokumentation

TXLSFormatSnapshot klass

Enhet: lxHandle
En återanvändbar ögonblicksbild av ett cellintervalls fullständiga formatering, fångad av IXLSRange.CaptureFormat och tillämpad med IXLSRange.ApplyFormat

Beskrivning

TXLSFormatSnapshot innehåller hela cellformatet (typsnitt, fyllningar, ramar, talformat, justering, skydd och rich-text-färgplatser) som fångats vid en given tidpunkt. Ögonblicksbilden är oberoende av arbetsboken den kommer från, så den kan tillämpas på intervall i samma eller en annan arbetsbok. Instanser skapas av IXLSRange.CaptureFormat; anroparen äger det returnerade objektet och måste frigöra det.
Varje färgattribut som känner till tema och palett lagras som en TXLSXfRichSlot-post — den upplösta färgen plus vilken rikare källa den kom från — och platspositionerna identifieras med TXLSXfRichSlotID (rsFillFg, rsFillBg, rsFont, rsTop, rsBottom, rsLeft, rsRight, rsDiag); ögonblicksbilden grupperar dem i en TXLSXfRichColors-aggregat, och TXLSXfRichSlotSet markerar flera platser i ett anrop så att en enda sättare kan omstyla fyllnings-, typsnitts- och ramfärger tillsammans.

Metoder

procedure ApplyTo(const ARange: IXLSRange) — tillämpar denna ögonblicksbild på det angivna intervallet

Exempel

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

Se även