HotXLS-dokumentasjon

klasse TXLSFormatSnapshot

Enhet: lxHandle
Et gjenbrukbart øyeblikksbilde av den fullstendige formateringen til et celleområde, fanget av IXLSRange.CaptureFormat og brukt med IXLSRange.ApplyFormat

Beskrivelse

TXLSFormatSnapshot inneholder hele celleformateringen (fonter, fyllinger, kanter, tallformater, justering, beskyttelse og riktekst-fargeplasser) fanget på et bestemt tidspunkt. Øyeblikksbildet er uavhengig av arbeidsboken det kom fra, så det kan brukes på områder i samme eller en annen arbeidsbok. Forekomster opprettes av IXLSRange.CaptureFormat; kalleieren eier det returnerte objektet og må frigjøre det.
Hvert tema- og palettbevisst fargeattributt lagres som en TXLSXfRichSlot-post — den oppløste fargen pluss hvilken rikere kilde den kom fra — og slottposisjonene identifiseres med TXLSXfRichSlotID (rsFillFg, rsFillBg, rsFont, rsTop, rsBottom, rsLeft, rsRight, rsDiag); snapshotet grupperer dem i et TXLSXfRichColors-aggregat, og TXLSXfRichSlotSet velger flere slots i ett kall, slik at én enkelt setter kan restyle fyll-, font- og kantfarger samlet.

Metoder

procedure ApplyTo(const ARange: IXLSRange) — bruker dette øyeblikksbildet på det angitte området

Eksempel

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

Se også