Metoda ApplyBiffPalettePlan
Waliduje i atomowo stosuje 56 kolorów docelowych z planu palety BIFF
Metoda jest dostępna zarówno w IXLSWorkbook, jak i w TXLSXWorkbook
Składnia
function ApplyBiffPalettePlan( const APlan: TXLSBiffPalettePlan): Boolean;
Walidacja
Metoda zwraca False bez zmieniania jakiegokolwiek slotu, gdy plan nie odpowiada bieżącej palecie skoroszytu
Walidacja obejmuje generację palety źródłowej i skrót FNV-1a, wszystkie 56 publicznych i fizycznych indeksów slotów, każdy kolor źródłowy, flagi zablokowania i zmiany, zagregowane liczniki slotów oraz nieprzezroczyste kolory docelowe
Plan staje się nieaktualny po każdej skutecznej zmianie palety, w tym po wcześniejszym pomyślnym zastosowaniu tego samego planu
Atomowe stosowanie
Cała walidacja kończy się przed zmianą pierwszego wpisu palety
Klasyczny XLS aktualizuje stałą tablicę palety i jednorazowo przebudowuje swój cache'owany dopasowywacz OKLab
XLSX przygotowuje zastępczą listę nadpisań kolorów indeksowanych przed podstawieniem jej do skoroszytu i również jednorazowo przebudowuje swój dopasowywacz
Zablokowane sloty nigdy nie mogą się zmienić, a prawidłowy plan bez zmienionych slotów kończy się powodzeniem bez zwiększania generacji palety
Przykład
Plan := Workbook.BuildBiffPalettePlan;
if not Workbook.ApplyBiffPalettePlan(Plan) then
raise Exception.Create('The palette changed after planning');