ApplyBiffPalettePlan metode
Validerer og anvender atomisk de 56 målfarver fra en BIFF-paletplan
Metoden er tilgængelig på både IXLSWorkbook og TXLSXWorkbook
Syntaks
function ApplyBiffPalettePlan( const APlan: TXLSBiffPalettePlan): Boolean;
Validering
Metoden returnerer False uden at ændre nogen slot, når planen ikke matcher projektmappens aktuelle palet
Valideringen dækker kildepallettens generation og FNV-1a-hash, alle 56 offentlige og fysiske slotindeks, hver kildefarve, låste- og ændrede-flag, de samlede slotoptællinger og uigennemsigtige målfarver
En plan bliver forældet efter enhver effektiv paletændring, herunder en tidligere vellykket anvendelse af den pågældende plan
Atomisk anvendelse
Al validering afsluttes, før den første paletindgang ændres
Classic XLS opdaterer det faste paletarray og genopbygger sin cachede OKLab-matcher én gang
XLSX forbereder en erstatningsliste over indekserede farve-overskrivelser, inden den byttes ind i projektmappen, og genopbygger ligeledes sin matcher én gang
Låste slots kan aldrig ændres, og en gyldig plan uden ændrede slots lykkes uden at fremføre palettens generation
Eksempel
Plan := Workbook.BuildBiffPalettePlan;
if not Workbook.ApplyBiffPalettePlan(Plan) then
raise Exception.Create('The palette changed after planning');