TXLSFormatSnapshot class - HotXLS Developer Reference

Unit: lxHandle

Uno snapshot riutilizzabile della formattazione completa di un intervallo di celle, catturato da IXLSRange.CaptureFormat e applicato con IXLSRange.ApplyFormat

Description

TXLSFormatSnapshot contiene il formato completo della cella (font, riempimenti, bordi, formati numerici, allineamento, protezione e slot di colore del testo ricco) catturato in un determinato momento. Lo snapshot è indipendente dal workbook da cui proviene, quindi può essere applicato a range nello stesso workbook o in un workbook diverso. Le istanze vengono create da IXLSRange.CaptureFormat; il chiamante è proprietario dell'oggetto restituito e deve liberarlo.

Ogni attributo di colore che tiene conto di tema e palette viene memorizzato come record TXLSXfRichSlot — il colore risolto più la sorgente più ricca da cui proviene — e le posizioni degli slot sono identificate da TXLSXfRichSlotID (rsFillFg, rsFillBg, rsFont, rsTop, rsBottom, rsLeft, rsRight, rsDiag); lo snapshot li raggruppa nell'aggregato TXLSXfRichColors, e TXLSXfRichSlotSet seleziona più slot in una sola chiamata, così un singolo setter può restilire insieme i colori di riempimento, font e bordo.

Metodi

procedure ApplyTo(const ARange: IXLSRange) — applica questo snapshot al range specificato

Esempio

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

Vedere also

IXLSRange.CaptureFormatmetodo
IXLSRange.ApplyFormatmetodo
Interfaccia IXLSRange