مستندات HotXLS

کلاس TXLSFormatSnapshot

واحد: lxHandle
یک snapshot قابل استفاده مجدد از قالب‌بندی کامل یک محدوده سلول، ثبت‌شده توسط IXLSRange.CaptureFormat و اعمال‌شده با IXLSRange.ApplyFormat

توضیحات

TXLSFormatSnapshot قالب کامل سلول (فونت‌ها، پرها، حاشیه‌ها، قالب‌های عددی، تراز، محافظت و اسلات‌های رنگ متن غنی) ثبت‌شده در یک نقطه زمانی را نگه می‌دارد. Snapshot مستقل از کتاب‌کاری است که از آن آمده است، بنابراین می‌توان آن را روی محدوده‌هایی در همان کتاب‌کار یا یک کتاب‌کار دیگر اعمال کرد. نمونه‌ها توسط IXLSRange.CaptureFormat ایجاد می‌شوند؛ فراخواننده مالک شیء برگشتی است و باید آن را آزاد کند.
هر ویژگی رنگی آگاه از theme و پالت به‌صورت یک رکورد TXLSXfRichSlot ذخیره می‌شود — یعنی رنگ نهایی به‌علاوه منبع غنی‌تری که از آن آمده — و موقعیت اسلات‌ها با TXLSXfRichSlotID مشخص می‌شود (rsFillFg، rsFillBg، rsFont، rsTop، rsBottom، rsLeft، rsRight، rsDiag)؛ snapshot این‌ها را در یک مجموعه TXLSXfRichColors گروه‌بندی می‌کند و TXLSXfRichSlotSet چند اسلات را در یک فراخوانی انتخاب می‌کند تا یک setter بتواند رنگ fill، فونت و کادر را با هم بازقالب‌بندی کند.

متدها

procedure ApplyTo(const ARange: IXLSRange) — این snapshot را روی محدوده داده‌شده اعمال می‌کند

مثال

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

همچنین ببینید