Docs HotXLS
Accueil Sommaire IXLSRange

TXLSFormatSnapshot-class

Unité : lxHandle
Un instantané réutilisable du format complet d'une plage de cellules, capturé par IXLSRange.CaptureFormat et appliqué avec IXLSRange.ApplyFormat

Description

TXLSFormatSnapshot contient le format complet de la cellule (polices, remplissages, bordures, formats numériques, alignement, protection et emplacements de couleurs de texte enrichi) capturé à un instant donné. L'instantané est indépendant du classeur dont il provient, il peut donc être appliqué à des plages du même classeur ou d'un classeur différent. Les instances sont créées par IXLSRange.CaptureFormat ; l'appelant possède l'objet renvoyé et doit le libérer.
Chaque attribut de couleur sensible au thème et à la palette est stocké sous forme d'enregistrement TXLSXfRichSlot — la couleur résolue plus la source enrichie dont elle provient — et les positions des emplacements sont identifiées par TXLSXfRichSlotID (rsFillFg, rsFillBg, rsFont, rsTop, rsBottom, rsLeft, rsRight, rsDiag) ; l'instantané les regroupe dans un agrégat TXLSXfRichColors, et TXLSXfRichSlotSet sélectionne plusieurs emplacements en un seul appel afin qu'un seul setter puisse restyler ensemble les couleurs de remplissage, de police et de bordure.

Méthodes

procedure ApplyTo(const ARange: IXLSRange) — applique cet instantané à la plage donnée

Exemple

var
  Snapshot: TXLSFormatSnapshot;
begin
  Snapshot:= Workbook.Sheets[1].Range['A1', 'D1'].CaptureFormat;
  Snapshot.ApplyTo(Workbook.Sheets[2].Range['A1', 'D1']);
  Snapshot.Free;
end;

Voir aussi

CaptureFormat méthode
ApplyFormat méthode
IXLSRange interface