Método ApplyBiffPalettePlan
Valida e aplica atomicamente as 56 cores de destino de um plano de paleta BIFF
O método está disponível tanto em IXLSWorkbook como em TXLSXWorkbook
Sintaxe
function ApplyBiffPalettePlan( const APlan: TXLSBiffPalettePlan): Boolean;
Validação
O método devolve False sem alterar nenhuma ranhura quando o plano não corresponde à paleta atual do livro de trabalho
A validação abrange a geração da paleta de origem e o hash FNV-1a, todos os 56 índices de ranhuras públicas e físicas, cada cor de origem, os sinalizadores de bloqueio e de alteração, as contagens agregadas de ranhuras e as cores de destino opacas
Um plano torna-se obsoleto após qualquer alteração efetiva da paleta, incluindo uma aplicação anterior bem-sucedida desse mesmo plano
Aplicação atómica
Toda a validação termina antes de a primeira entrada da paleta ser alterada
O XLS clássico atualiza a matriz fixa da paleta e reconstrói o seu correspondente OKLab em cache uma única vez
O XLSX prepara uma lista de substituição de cores indexadas antes de a trocar no livro de trabalho e também reconstrói o seu correspondente uma única vez
As ranhuras bloqueadas nunca podem ser alteradas e um plano válido sem ranhuras alteradas é concluído com sucesso sem avançar a geração da paleta
Exemplo
Plan := Workbook.BuildBiffPalettePlan;
if not Workbook.ApplyBiffPalettePlan(Plan) then
raise Exception.Create('The palette changed after planning');