دعم تصدير TDBGrid

وحدة الإضافة dbGridHotPDFExport (Lib\addons\DBGrid) تكتب أعمدة TDBGrid المرئية وكل صفوف مجموعة بياناتها في جدول PDF. وهي تنشئ مستند THotPDF خاصًا بها وتملؤه وتحفظه، فالشبكة هي المدخل الوحيد الذي تحتاجه

نقاط الدخول

• DBGridHotPDFExportToFile(AGrid, AOutputFileName[, AOptions]) تكتب الـ PDF في ملف
• DBGridHotPDFExportToStream(AGrid, AOutputStream[, AOptions]) تكتبه في تدفق، عبر ملف مؤقت في %TEMP%
• DBGridHotPDFDefaultOptions تعيد سجل TDBGridHotPDFExportOptions بالقيم الافتراضية: A4 بالنقطة (595 × 842)، وهوامش 36 نقطة، وصفوف 22 نقطة، وصف رأس 24 نقطة، وخط Arial 9 مع عنوان 14 نقطة، ورأس بلون clBtnFace وصفوف متناوبة بلون $00F5F5F5
• TDBGridHotPDFExport هو التصدير نفسه كمكوّن على لوحة HotPDF (يسجّله dbGridHotPDFDesign): اضبط Grid وOutputFileName ثم استدعِ ExportToFile أو ExportToStream. كل حقل خيارات خاصية منشورة، وResetOptions يستعيد الافتراضيات

ما الذي يُصدَّر

• الأعمدة المرئية للشبكة التي لها حقل، بترتيب الشبكة وبعناوين أعمدتها، أو الحقول المرئية لمجموعة البيانات عندما لا تكون للشبكة أعمدة؛ وتحافظ عروض الأعمدة على نسب الشبكة عبر عرض الطباعة
• كل سجل من First إلى Eof، باستخدام DisplayText الخاص بكل حقل؛ ونص الخلية الذي لا يتسع يُقتطع وينتهي بـ ...
• كل النصوص تستخدم FontName الذي يجب أن يملك رموز البيانات: خط Arial الافتراضي يُظهر النصوص الصينية أو اليابانية أو الكورية مربعات فارغة، فاضبط خط CJK مثل Microsoft YaHei لمثل هذه البيانات
• تبدأ صفحة جديدة عندما يتجاوز الصف التالي الهامش السفلي، ويتكرر صف الرأس في كل صفحة. يُرسم العنوان (Title وإلا Name الخاص بالشبكة) مرة واحدة في الصفحة الأولى ما دامت IncludeTitle تساوي True
• القيم Title وAuthor وSubject وKeywords وPDFVersion (افتراضيًا pdf17) وPDFACompliance وPDFXCompliance وCompression تُمرَّر إلى المستند

حالة مجموعة البيانات

• يستدعي التصدير DisableControls أثناء تنقله في مجموعة البيانات وEnableControls بعده، فلا تعيد عناصر التحكم المرتبطة الرسم لكل صف
• يُحفظ السجل الحالي بعلامة مرجعية أولًا ويُستعاد في النهاية، ويُستعاد كذلك عندما يفشل التصدير
• شبكة nil أو اسم ملف فارغ أو شبكة بلا مجموعة بيانات أو مجموعة بيانات غير نشطة أو شبكة بلا أعمدة بيانات مرئية تثير استثناء بدلًا من إعادة False

مثال

uses
  dbGridHotPDFExport;

var
  Options: TDBGridHotPDFExportOptions;
begin
  Options:= DBGridHotPDFDefaultOptions;
  Options.Title:= 'Customers';
  Options.PageWidth:= 842;   // A4 landscape
  Options.PageHeight:= 595;
  DBGridHotPDFExportToFile(DBGrid1, 'Customers.pdf', Options);
end;

واجهات برمجة التطبيقات ذات الصلة

• صنف THotPDF
• صنف THPDFPage
• نظرة عامة على HotPDF