Metodo ApplyBiffPalettePlan
Valida e applica in modo atomico i 56 colori di destinazione di un piano della tavolozza BIFF
Il metodo è disponibile sia su IXLSWorkbook sia su TXLSXWorkbook
Sintassi
function ApplyBiffPalettePlan( const APlan: TXLSBiffPalettePlan): Boolean;
Validazione
Il metodo restituisce False senza modificare alcuno slot quando il piano non corrisponde alla tavolozza corrente del workbook
La validazione copre la generazione della tavolozza di origine e l'hash FNV-1a, tutti i 56 indici di slot pubblici e fisici, ogni colore di origine, i flag di blocco e di modifica, i conteggi aggregati degli slot e i colori di destinazione opachi
Un piano diventa obsoleto dopo qualsiasi modifica effettiva della tavolozza, compresa una precedente applicazione riuscita dello stesso piano
Applicazione atomica
Tutta la validazione termina prima che la prima voce della tavolozza venga modificata
XLS classico aggiorna l'array fisso della tavolozza e ricostruisce una sola volta il suo matcher OKLab in cache
XLSX prepara un nuovo elenco di override dei colori indicizzati prima di sostituirlo nel workbook e ricostruisce anch'esso il matcher una sola volta
Gli slot bloccati non possono mai cambiare e un piano valido senza slot modificati ha successo senza far avanzare la generazione della tavolozza
Esempio
Plan := Workbook.BuildBiffPalettePlan;
if not Workbook.ApplyBiffPalettePlan(Plan) then
raise Exception.Create('The palette changed after planning');