StoreCustomDataFromFileA

خصائص المستند

الوصف

تشير اللاحقة A إلى نقطة دخول DLL بصيغة ANSI (char)؛ وتبقى واجهة ActiveX/COM مكشوفةً بالصيغة Unicode فقط. والسلوك مطابق لـ StoreCustomDataFromFile وتُفسر وسائط السلاسل بصفحة شيفرة SetAnsiMode الحالية

يحفظ بيانات مخصصة من ملف في PDF تحت اسم مفتاح. ويمكن استرجاع هذه البيانات لاحقًا باستخدام RetrieveCustomDataToString أو RetrieveCustomDataToFile. ويمكن ضبط نوع التخزين (سلسلة أو تدفق أو تدفق مضغوط) والموقع (قاموس معلومات المستند أو كتالوج المستند). إذا كان الموقع هو كتالوج المستند فيمكن استخدام أي نوع تخزين، لكن يجب أن يحمل المفتاح بادئة خاصة خصصت لك من Adobe. وإذا كان الموقع هو قاموس معلومات المستند فيمكن استخدام أي مفتاح غير المفاتيح القياسية، لكن السلاسل فقط هي المسموح بها

الصيغة

Delphi

Function DLStoreCustomDataFromFileA(InstanceID: Integer; Key, FileName: PAnsiChar; Location, Options: Integer): Integer;

DLL

int DLStoreCustomDataFromFileA(int InstanceID, const char * Key, const char * FileName, int Location, int Options);

المعاملات

Keyالمفتاح الذي ستُخزَّن البيانات تحته. إذا كان الموقع هو قاموس معلومات المستند فلا يمكن أن يكون المفتاح "Author" أو "Title" أو "Subject" أو "Keywords" أو "Creator" أو "Producer". ويمكن استخدام أي مفتاح آخر، لكن ينبغي اختيار المفاتيح بعناية بحيث تكون مفهومة للمستخدم. وإذا كان الموقع هو كتالوج المستند فيجب أن يحمل المفتاح بادئة خاصة خصصت لك من Adobe لتجنب التعارض مع البرامج الأخرى
FileNameمسار واسم الملف الذي يحتوي البيانات المطلوب تخزينها في PDF تحت المفتاح المحدد
Location1 = تخزين البيانات في قاموس معلومات المستند 2 = تخزين البيانات في كتالوج المستند
Options0 = تخزين البيانات كسلسلة (الخيار الوحيد المتاح إذا كان الموقع هو قاموس معلومات المستند) 1 = تخزين البيانات في تدفق 2 = تخزين البيانات في تدفق مضغوط

قيم الإرجاع

0تعذر فتح الملف الذي يحتوي على البيانات، أو كانت الوسيطة Key غير صالحة
1خُزِّنت البيانات بنجاح