مستندات HotXLS

فئة TXLSFormatSnapshot

الوحدة: 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;

انظر أيضاً