Méthode ApplyBiffPalettePlan
Valide et applique atomiquement les 56 couleurs cibles d'un plan de palette BIFF
La méthode est disponible sur IXLSWorkbook et TXLSXWorkbook
Syntaxe
function ApplyBiffPalettePlan( const APlan: TXLSBiffPalettePlan): Boolean;
Validation
La méthode renvoie False sans modifier aucun emplacement lorsque le plan ne correspond pas à la palette actuelle du classeur
La validation couvre la génération de la palette source et le hachage FNV-1a, les 56 index d'emplacements publics et physiques, chaque couleur source, les indicateurs verrouillé et modifié, les totaux d'emplacements et les couleurs cibles opaques
Un plan devient obsolète après toute modification effective de la palette, y compris une application antérieure réussie de ce plan
Application atomique
Toute la validation se termine avant la modification de la première entrée de palette
XLS classique met à jour le tableau de palette fixe et reconstruit une seule fois son comparateur OKLab en cache
XLSX prépare une liste de remplacement des couleurs indexées avant de l'insérer dans le classeur et reconstruit également son comparateur une seule fois
Les emplacements verrouillés ne peuvent jamais changer et un plan valide sans emplacement modifié réussit sans faire avancer la génération de la palette
Exemple
Plan := Workbook.BuildBiffPalettePlan;
if not Workbook.ApplyBiffPalettePlan(Plan) then
raise Exception.Create('The palette changed after planning');