StoreCustomDataFromString
خصائص المستند
الوصف
يحفظ بيانات مخصصة في PDF تحت اسم مفتاح. ويمكن استرجاع هذه البيانات لاحقًا باستخدام دوال RetrieveCustomDataToString أو RetrieveCustomDataToVariant أو RetrieveCustomDataToFile. ويمكن ضبط نوع التخزين (سلسلة أو تدفق أو تدفق مضغوط) والموقع (قاموس معلومات المستند أو كتالوج المستند). إذا كان الموقع هو كتالوج المستند فيمكن استخدام أي نوع تخزين، لكن يجب أن يحمل المفتاح بادئة خاصة خصصت لك من Adobe. وإذا كان الموقع هو قاموس معلومات المستند فيمكن استخدام أي مفتاح غير المفاتيح القياسية، لكن السلاسل فقط هي المسموح بها
عندما تكون Location تساوي 2 تكون مفاتيح الكتالوج النظامية محجوزة وتُرجع 0 بدلًا من الكتابة فوقها. وتشمل المجموعة المحجوزة OutputIntents التي تديرها سير عمل PDF/A وإخراج الألوان
الصيغة
Delphi
Function TPDFlib.StoreCustomDataFromString(Const Key, NewValue: AnsiString; Location, Options: Integer): Integer;DLL
int DLStoreCustomDataFromString(int InstanceID, const char * Key, const char * NewValue, int Location, int Options);المعاملات
| Key | المفتاح الذي ستُخزَّن البيانات تحته. إذا كان الموقع هو قاموس معلومات المستند فلا يمكن أن يكون المفتاح "Author" أو "Title" أو "Subject" أو "Keywords" أو "Creator" أو "Producer". ويمكن استخدام أي مفتاح آخر، لكن ينبغي اختيار المفاتيح بعناية بحيث تكون مفهومة للمستخدم. وإذا كان الموقع هو كتالوج المستند فيجب أن يحمل المفتاح بادئة خاصة خصصت لك من Adobe لتجنب التعارض مع البرامج الأخرى |
|---|---|
| NewValue | القيمة الجديدة للبيانات |
| Location | 1 = تخزين البيانات في قاموس معلومات المستند 2 = تخزين البيانات في كتالوج المستند |
| Options | 0 = تخزين البيانات كسلسلة (الخيار الوحيد المتاح إذا كان الموقع هو قاموس معلومات المستند) 1 = تخزين البيانات في تدفق 2 = تخزين البيانات في تدفق مضغوط |
قيم الإرجاع
| 0 | تعذّر تخزين البيانات لأن اسم المفتاح اسم محجوز |
|---|---|
| 1 | خُزِّنت البيانات بنجاح |