وثائق HotXLS / مرجع API

خطط الطباعة المحمولة

افصل الترقيم المنطقي عن الإخراج الأصلي: ينشئ lxPortablePrint خطة طباعة غير قابلة للتغيير من لقطة عرض منفصلة، ويرسم lxPortableCairo صفحاتها PDF أو SVG أو PNG على Linux وmacOS

يستخدم المخطِّط النقاط الفيزيائية وحدود الخلايا الكاملة ويحفظ النطاقات المدمجة ويكرر عناوين الصفوف والأعمدة ويطبق مناطق طباعة منفصلة وفواصل يدوية واتجاهًا وهوامش وتوسيطًا وتحجيمًا وترتيب صفحات دون تغيير المصنف المصدر

استخدام إعداد صفحة المصنف

تضم CreateXLSPortableWorkbookPrintPlan في lxPortableWorkbookPrint حمولات زائدة لـ TXLSWorkbook وTXLSXWorkbook المستعارين؛ وتقبل كلتاهما SheetIndex وOriginRow وOriginColumn وSnapshot وDefaults

فهرس الورقة وأصل اللقطة قائمان على الواحد؛ ويتطلب المهايئ لقطة من جيل المصنف الحالي ومستطيلًا ملتقطًا يحتوي كل منطقة طباعة كاملة وكل نطاق تسميات متكررة

تدخل هوية اللقطة جيلَها، بينما يزود المستدعي الورقةَ والأصل المطابقين؛ واحتفظ بسياق الورقة الصحيح عند نقل لقطة لأن تنسيق اللقطة لا يشفّر هوية مصنف أو ورقة عمل

Snapshot := CaptureXLSPortableRenderSnapshot(Owner, 1, 1, 1, 30, 6,
  XLSDefaultPortableRenderLimits, Geometry);
Plan := CreateXLSPortableWorkbookPrintPlan(Workbook, 1, 1, 1,
  Snapshot, XLSDefaultPortablePrintOptions);
Layout := PrepareXLSPortableCairoLayout(Plan, Fonts,
  XLSDefaultPortableCairoOptions);
try
  Files := Layout.Save('/srv/output/report.pdf', xpcfPDF);
  Files := Layout.Save('/srv/output/report.svg', xpcfSVG);
  Files := Layout.Save('/srv/output/report.png', xpcfPNG);
finally
  Layout.Free;
end;

استخدم مزود الهندسة المدعوم بالخطوط الصريح الموصوف في الالتقاط الأصلي المباشر للمصنف عند الالتقاط على Linux أو macOS؛ أما الترقيم نفسه فلا يتطلب Cairo ولا ملفات خطوط ولا Excel ولا مشغل طابعة

يأخذ مهايئ المصنف عقد قراءة مؤقتًا ويقرأ البيانات الوصفية القائمة ويعيد بيانات منفصلة؛ وهو لا يتبنى مصنفًا خامًا عبر واجهة مالكة ولا يحتفظ بعقد مصنف في النتيجة

تُقبل أسماء الأوراق المقتبسة وعلامات الاقتباس المهروبة ومناطق الطباعة المفصولة بفواصل للورقة المختارة فقط؛ وتُرفض صراحةً المراجع خارج المستطيل الملتقط ومراجع الأوراق الأجنبية ونطاقات التسميات الناقصة والنطاقات المشوهة

أحجام الورق المعروفة هي Letter وTabloid وLedger وLegal وA3 وA4 وA5 وB4 وB5؛ ويستخدم حجم الورق غير المحدد ‏Defaults.PageWidthPoints وDefaults.PageHeightPoints، بينما يُرفض حجم ورق صريح غير معروف

محتوى الرأس والتذييل وعناوين الصفوف والأعمدة المطبوعة وخطوط شبكة الطباعة المفعلة والمظهر أحادي اللون أو المسودة وطباعة التعليقات وبدائل الأخطاء تُرفض حاليًا لأن هذا المهايئ يستطيع رسم تلك الإعدادات بأمانة؛ وتفعّل مصنفات Classic خطوط شبكة الطباعة افتراضيًا، فأعطّل PageSetup.PrintGridlines لهذا العقد المدعوم

وضع التحجيم والافتراضات الأصلية

يختار TXLSXWorksheet.PageFitToPages وضع الملاءمة استقلالًا عن أبعاده: ضبط FitToWidth أو FitToHeight يختار وضع الملاءمة، وضبط PageScale يختار التحجيم بالنسبة

يحفظ استيراد XLSX ‏sheetPr/pageSetUpPr/@fitToPage والافتراض OOXML وهو الواحد للبعد الملائم المحذوف؛ ويحفظ التصدير الأبعاد الصفرية الصريحة، ويحفظ تحويل XLS/XLSX الوضعَ المختار

يتجاهل التحجيم بالنسبة أبعاد الملاءمة المتقادمة؛ ويتجاهل وضع الملاءمة نسبة التحجيم المخزنة، وتتجاهل أبعاد الملاءمة الموجبة الفواصل اليدوية؛ والصفر على المحورين معًا يحفظ الفواصل اليدوية عند تحجيم 100%، بينما تصغّر الحدود الموجبة المحتوى الزائد دون تكبير نطاق صغير

يعتمد الترقيم المنطقي على هندسة اللقطة المزودة؛ وتستطيع مقاييس مشغل الطابعة وتحجيم تصدير PDF في Excel تغيير الإخراج الفيزيائي ولا يُعد ذلك ضمان تكافؤ بصري تام

بناء خطة منفصلة مباشرة

يقبل CreateXLSPortablePrintPlan(Snapshot, Areas, Options)‏ TXLSPortablePrintRanges شاملةً مبنية على الصفر؛ ومصفوفة Areas الفارغة تختار اللقطة كلها، ويحتوي كل TXLSPortablePrintRange‏ FirstRow وFirstColumn وLastRow وLastColumn

ابدأ بـ XLSDefaultPortablePrintOptions ثم عيّن حقول TXLSPortablePrintOptions أدناه

الحقولالعقد
PageWidthPoints, PageHeightPointsأبعاد ورق فيزيائية موجبة بالنقاط، والافتراض A4
MarginLeftPoints, MarginTopPoints, MarginRightPoints, MarginBottomPointsهوامش غير سالبة تترك مستطيل طباعة موجبًا، والافتراض 36 نقطة
Landscape, CenterHorizontally, CenterVerticallyيبدّل Landscape بعدَي الطول؛ ويطبق التوسيط على متن كل صفحة وتسمياتها المتكررة
ScalePercentمن 10 إلى 400 والافتراض 100؛ ويطبق عندما لا يكون أي بعد ملاءمة موجبًا
FitToPagesWide, FitToPagesTallحدود صفحات غير سالبة والصفر محورًا بلا قيد؛ وتجد الحدود الموجبة تحجيمًا ممكنًا بين 10% و100%
TitleFirstRow, TitleLastRow, TitleFirstColumn, TitleLastColumnنطاقات تسميات كاملة شاملة مبنية على الصفر، أو ‎-1 على الطرفين لتعطيل ذلك المحور
RowBreaks, ColumnBreaksمصفوفات TXLSPortablePrintBreaks بمواضع فريدة متزايدة بدقة مبنية على الصفر يبدأ عندها صفحة جديدة؛ وترتب موائمة المصنف البياناتَ الوصفية المنفصلة دون تحرير الورقة
OrderTXLSPortablePrintOrder: ‏xppoDownThenOver أو xppoOverThenDown
MaxPagesحد إجمالي موجب للصفحات، افتراضه 256 وأقصاه 100,000
MaxPlanBytesيتقاسم تخزين العمل وحمولة اللقطة المنفصلة وسجلات الصفحات ميزانية الذاكرة الموجبة هذه، افتراضها 64 ميبيبايت وأقصاها 1 جيبيبايت
MaxPlanningStepsميزانية عمل تخطيط موجبة محدودة، افتراضها 64 مليون خطوة وأقصاها 2 مليار خطوة؛ وتجاوزها يثير EXLSPortablePrintBudget

يجب أن تكون الهندسة منتهية؛ وللأبعاد المخفية حجم صفري، ولا يجوز لفاصل صفحة أن يقطع دمجًا، ولا يجوز لمنطقة أو تسمية أن تتقاطع جزئيًا مع دمج، وتُرفض الخلية أو الدمج الزائد الحجم بدلًا من قصّه بصمت

فحص النتيجة أو عرضها

تملك IXLSPortablePrintPlan.Snapshot لقطة عرض منفصلة غير قابلة للتغيير، ويبلّغ PageCount عن عدد الصفحات المنطقية، وتعيد Pages[Index] المبنية على الصفر ‏TXLSPortablePrintPage بمصفوفة بلاطات منفصلة

تعرض كل صفحة AreaIndex وAcrossIndex وDownIndex وBody الشاملة المبنية على الصفر وScale وPageWidthPoints وPageHeightPoints وTiles

تحتوي TXLSPortablePrintTiles على أربعة سجلات TXLSPortablePrintTile كحد أقصى للزاوية المتكررة وصفوف التسميات وأعمدة التسميات والمتن؛ ويعرض كل بلاطة مصدرًا غير محجَّم ‏SourceLeft وSourceTop وSourceRight وSourceBottom ووجهة فيزيائية ‏DestinationLeft وDestinationTop

تحتفظ حمولة PrepareXLSPortableCairoLayout(Plan, Fonts, Options) بسجلات الصفحات المنفصلة وتقص محتوى المشهد وتحجّمه لكل بلاطة وتستخدم أبعاد ورق الخطة وهوامشها؛ وتبقى ميزانيات الصورة النقطية والخطوط والتشكيل والرسم مطبقةً على المحتوى المتكرر

يطابق Layout.PageCount الخطة؛ وينتج PDF ملفًا واحدًا متعدد الصفحات بينما ينتج SVG وPNG ملفًا واحدًا لكل صفحة منطقية؛ ويحتفظ فحص أسطر النص في التخطيط بإحداثيات اللقطة غير المحجَّمة لا بالمواضع المتكررة لكل صفحة

تُرفض ملفات الإخراج القائمة، وتبقى نقطة دخول Cairo الأصلية على Windows غير مدعومة صراحةً؛ وراجع الإخراج headless المحمول للتبعيات وتعيين الخطوط وحدود المشهد والإخراج