Клас TXLSFormatSnapshot - Довідник розробника HotXLS

Модуль: lxHandle

Багаторазовий знімок повного форматування діапазону комірок, захоплений за допомогою IXLSRange.CaptureFormat і застосований за допомогою IXLSRange.ApplyFormat

Опис

TXLSFormatSnapshot містить повний формат комірки (шрифти, заливки, межі, числові формати, вирівнювання, захист і слоти кольорів форматованого тексту), захоплений у певний момент часу. Знімок не залежить від робочої книги, з якої він походить, тож його можна застосувати до діапазонів у тій самій чи іншій робочій книзі. Екземпляри створюються за допомогою IXLSRange.CaptureFormat; викликач володіє поверненим об'єктом і має звільнити його.

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

Методи

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