HotXLS-Dokumentation

ApplyBiffPalettePlan-Methode

Validiert die 56 Zielfarben eines BIFF-Palettenplans und wendet sie atomar an

Die Methode ist sowohl für IXLSWorkbook als auch für TXLSXWorkbook verfügbar

Syntax

function ApplyBiffPalettePlan(
  const APlan: TXLSBiffPalettePlan): Boolean;

Validierung

Die Methode gibt False zurück, ohne einen Slot zu ändern, wenn der Plan nicht zur aktuellen Arbeitsmappenpalette passt

Die Validierung umfasst die Quellpaletten-Generation und den FNV-1a-Hash, alle 56 öffentlichen und physischen Slotindizes, jede Quellfarbe, die gesperrten und geänderten Flags, die aggregierten Slotzähler und die opaken Zielfarben

Ein Plan wird veraltet, sobald eine wirksame Palettenänderung erfolgt, einschließlich einer früheren erfolgreichen Anwendung genau dieses Plans

Atomare Anwendung

Die gesamte Validierung ist abgeschlossen, bevor sich der erste Paletteneintrag ändert

Classic XLS aktualisiert das feste Palettenarray und baut seinen zwischengespeicherten OKLab-Matcher einmal neu auf

XLSX bereitet eine Ersatzliste mit indizierten Farbüberschreibungen vor, tauscht sie in die Arbeitsmappe ein und baut ebenfalls seinen Matcher einmal neu auf

Gesperrte Slots können sich nie ändern, und ein gültiger Plan ohne geänderte Slots ist erfolgreich, ohne die Paletten-Generation voranzustellen

Beispiel

Plan := Workbook.BuildBiffPalettePlan;
if not Workbook.ApplyBiffPalettePlan(Plan) then
  raise Exception.Create('The palette changed after planning');

Siehe auch