THotPDF.PrepareLoadedFormDataRevisionToStream
تهيئ مراجعة خاصة للرسم البياني الفعلي المحمَّل دون تغيير المستند الأصلي
الإعلان
procedure PrepareLoadedFormDataRevisionToStream(Destination: TStream;
const Password: AnsiString; MaxWorkingBytes, MaxOutputBytes: Int64;
MaxObjects: Integer; Checkpoint: TNotifyEvent = nil;
OriginalSource: TStream = nil);
السلوك
الأسلوب ينسخ المراجعة الأصلية إلى ملف خاص مُنشأ حصريًا، ويحمّل مستندًا تزايديًا منفصلًا، ويقارن الرسوم البيانية الدلالية للكائنات بالرقم والتوليد، ويستنسخ التغييرات المعلّقة الفعلية، ثم يكتب المرشّح الناتج عند الموضع الحالي للوجهة
القيم النصية والمظاهر القائمة وتغييرات الكتالوج المعلقة غير المرتبطة والمراجع غير المباشرة ومحتويات المسارات وكائنات الرسم البياني الجديدة كلها تدخل في التهيئة؛ وأسماء PDF تفك مرة واحدة وأسماء القواميس الدلالية المكررة غير صالحة
الرسم البياني غير المتغيّر ينسخ البايتات الأصلية الدقيقة دون إضافة مقطع مراجع متقاطع تزايدي فارغ؛ والرسوم المتغيّرة تحفظ بادئة البايتات الأصلية كاملة وتُلحق مراجعتها الحالية
المراجعات المشفرة تحفظ قاموس التشفير والمفتاح الأصليين؛ وPassword يجب أن يصادق على المراجعة الأصلية ويقدَّم بايتات UTF-8
OriginalSource، عند توفيرها، يجب أن تكون المراجعة الأصلية الكاملة غير القابلة للتغيير التي حُمِّل منها هذا المستند، بما يشمل الـ ciphertext والبايتات الموقَّعة؛ ويُستعاد موضعها عند النجاح والفشل
بدون OriginalSource، يستخدم الأسلوب CopyLoadedSourceToStream؛ وذلك لا يحوّل مصدرًا مستعارًا قابلًا للتغيير خارجيًا إلى snapshot غير قابل للتغيير، لذا على المستدعين حفظ بايتاته المحمَّلة بدقة
MaxWorkingBytes يجب أن تكون 1 MiB على الأقل؛ وMaxOutputBytes وMaxObjects يجب أن تكون موجبة؛ ونسخ المصدر ومقارنة الكائنات وبيانات الاستنساخ المقيمة والمسكوبة وطول المخرجات لها سقوف منتهية
OperationCancellationToken وCheckpoint يُستقصيان أثناء النسخ والمقارنة؛ والنسخ يستخدم كتلًا لا تتجاوز 64 KiB؛ وتهيئة فاشلة قد تترك بايتات وجهة جزئية يجب على المستدعي إهلاكها
هذا الأسلوب منخفض المستوى يهيئ مراجعة رسم بياني ولا يصرّح بالتغييرات المعلقة بموجب DocMDP أو FieldMDP؛ استخدم THPDFWindowsFormDataTransaction لمصادقة سياسة التواقيع قبل نشر تحديثات النموذج
الرسم البياني الأصلي لـ THotPDF وملكية المصدر والتغييرات المعلقة والإعدادات تبقى سليمة عند نجاح التهيئة أو فشلها؛ والملفات المؤقتة تُغلق وتُزال عند خروج الأسلوب
مواضع مرتبطة
CopyLoadedSourceToStream, THPDFWindowsFormDataTransaction, تبادل Windows للـ FDF/XFDF