HotXLS-Dokumentation
Start Inhalt IXLSRange

TXLSFormatSnapshot-Klasse

Unit: lxHandle
Ein wiederverwendbarer Snapshot der vollständigen Formatierung eines Zellbereichs, der von IXLSRange.CaptureFormat erfasst und mit IXLSRange.ApplyFormat angewendet wird

Beschreibung

TXLSFormatSnapshot enthält das vollständige Zellformat (Schriftarten, Füllungen, Rahmen, Zahlenformate, Ausrichtung, Schutz und Rich-Text-Farbplätze), das zu einem bestimmten Zeitpunkt erfasst wurde. Der Snapshot ist unabhängig von der Arbeitsmappe, aus der er stammt, sodass er auf Bereiche in derselben oder einer anderen Arbeitsmappe angewendet werden kann. Instanzen werden von IXLSRange.CaptureFormat erstellt; der Aufrufer besitzt das zurückgegebene Objekt und muss es freigeben.
Jedes themen- und palettenbewusste Farbattribut wird als TXLSXfRichSlot-Datensatz gespeichert — die aufgelöste Farbe plus die Information, welche reichhaltigere Quelle sie geliefert hat — und die Slot-Positionen werden über TXLSXfRichSlotID identifiziert (rsFillFg, rsFillBg, rsFont, rsTop, rsBottom, rsLeft, rsRight, rsDiag); der Snapshot gruppiert sie in einer TXLSXfRichColors-Aggregation, und TXLSXfRichSlotSet wählt mehrere Slots in einem Aufruf aus, sodass ein einziger Setter Füll-, Schrift- und Rahmenfarben gemeinsam umstylen kann.

Methoden

procedure ApplyTo(const ARange: IXLSRange) — wendet diesen Snapshot auf den angegebenen Bereich an

Beispiel

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

Siehe auch

IXLSRange.CaptureFormat-Methode
IXLSRange.ApplyFormat-Methode
IXLSRange-Schnittstelle