LoadFromMappedFile
إدارة المستندات، الأداء، إدخال من الملفات
الوصف
يحمّل ويحدد PDF محليًا عبر عرض معيَّن محدود للقراءة فقط، مسموحًا لقراءات الكائنات والتيارات الكبيرة المؤجلة بإعادة استخدام صفحات ملف نظام التشغيل دون احتجاز المصدر كاملًا في الذاكرة
الصيغة
Delphi
Function TPDFlib.LoadFromMappedFile(Const FileName, Password: WideString;
WindowSize: Int64= 0; Options: Integer= 0): Integer;المعاملات
| FileName | مسار ملف PDF المحلي |
|---|---|
| Password | كلمة المرور المستخدمة لفتح ملف PDF، أو سلسلة فارغة لمستند غير مشفر |
| WindowSize | حجم العرض المعيَّن المطلوب بالبايتات؛ والصفر يختار 64 MiB، وتُرفع القيم دون حبيبية تخصيص نظام التشغيل إلى تلك الحبيبية وتُسقف القيم فوق 1 GiB |
| Options | الصفر يسمح بالرجوع إلى تيار ملف للقراءة فقط، بينما يفشل PDF_MAPPED_FILE_REQUIRE_MAPPING ما لم يكن عرض معيَّن نشطًا |
القيم المُرجعة
| 0 | كانت الوسائط غير صالحة، أو تعذر فتح الملف، أو لم يتوفر التعيين المطلوب، أو تعذر تحميل ملف PDF؛ افحص LastErrorCode |
|---|---|
| 1 | حُمّل المستند وحدُد |
ملاحظات
تبني نسخ Windows عرضًا واحدًا للقراءة فقط وتعيد إسناده عند الطلب عند حدود دقة التخصيص؛ وتستخدم المنصات الأخرى وإخفاقات الإسناد عقد القراءة المطلقة نفسه فوق تدفق ملف عادي للقراءة فقط ما لم يكن الإسناد مطلوبًا
يحد العرض الافتراضي 64 ميجابايت استهلاك فضاء العناوين باستقلال عن حجم المصدر ويناسب الوصول المتناثر إلى ملفات محلية كبيرة؛ والعرض الأصغر يخفض فضاء العناوين المقيم على حساب عمليات إعادة إسناد أكثر
قراءات شرائح الكائنات المطلقة تنسخ مباشرة من العرض الحالي إلى تخزين يملكه المحلل دون تحريك مؤشر موضع التيار؛ وهذه ليست واجهة مؤشرات zero-copy دائمة لأن إعادة الإسناد تبطل عناوين العرض
يبقى المصدر مفتوحًا حتى يزال المستند المحمل، ويستطيع الحفظ أو الاستخراج المؤجل متابعة قراءته
OnPassword، تتلقى كل إعادة محاولة لكلمة مرور مرفوضة تيارًا معيَّنًا وحالة محلل جديديناستخدم
GetMappedFileInfo للتأكد من نشاط التعيين وفحص إحصاءات العرض والقراءة الحالية