Клас TXLSFormatSnapshot - Справочник за разработчици HotXLS

Модул: lxHandle

Многократно използваема снимка на пълното форматиране на диапазон от клетки, заснета от IXLSRange.CaptureFormat и приложена с IXLSRange.ApplyFormat

Описание

TXLSFormatSnapshot съдържа пълния формат на клетката (шрифтове, запълвания, граници, числови формати, подравняване, защита и слотове за цветове на обогатен текст), заснет в определен момент. Снимката е независима от работната книга, от която произхожда, така че може да бъде приложена към диапазони в същата или в различна работна книга. Инстанциите се създават от IXLSRange.CaptureFormat; извикващият притежава върнатия обект и трябва да го освободи.

Всеки атрибут за цвят, ориентиран към тема и палитра, се съхранява като запис TXLSXfRichSlot — разрешения цвят плюс от кой по-богат източник идва — а позициите на слотовете се идентифицират чрез TXLSXfRichSlotID (rsFillFg, rsFillBg, rsFont, rsTop, rsBottom, rsLeft, rsRight, rsDiag); снимката ги групира в агрегата TXLSXfRichColors, а TXLSXfRichSlotSet избира няколко слота в едно извикване, така че един-единствен setter може да преоформи цветовете на запълване, шрифт и граници едновременно.

Методи

procedure ApplyTo(const ARange: IXLSRange) — прилага тази снимка към дадения диапазон

Пример

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

Вижте също

Метод IXLSRange.CaptureFormat
Метод IXLSRange.ApplyFormat
Интерфейс IXLSRange