Метод ApplyBiffPalettePlan
Валидира и атомично прилага 56-те целеви цвята от план за BIFF палитра
Методът е наличен както в IXLSWorkbook, така и в TXLSXWorkbook
Синтаксис
function ApplyBiffPalettePlan( const APlan: TXLSBiffPalettePlan): Boolean;
Валидация
Методът връща False без да променя нито един слот, когато планът не съответства на текущата палитра на работната книга
Валидацията обхваща генерацията на изходната палитра и хеша FNV-1a, всичките 56 публични и физически индекса на слотове, всеки изходен цвят, флаговете за заключване и промяна, сборните бройки на слотовете и непрозрачните целеви цветове
Планът става остарял след всяко ефективно изменение на палитрата, включително предишно успешно приложение на същия план
Атомично приложение
Цялата валидация завършва, преди първият запис на палитрата да бъде променен
Classic XLS обновява фиксиранния масив на палитрата и еднократно престроява своя кеширан OKLab съпоставящ
XLSX подготвя заместващ списък с отмятания на индексирани цветове, преди да го замени в работната книга, и също престроява своя съпоставящ еднократно
Заключените слотове никога не могат да се променят, а валиден план без променени слотове успява без отместване на генерацията на палитрата
Пример
Plan := Workbook.BuildBiffPalettePlan;
if not Workbook.ApplyBiffPalettePlan(Plan) then
raise Exception.Create('The palette changed after planning');