SetCatalogInformation
خصائص المستند
الوصف
تتيح هذه الدالة تخزين معلومات مخصصة في مستند PDF. وهي مشابهة للدالة SetCustomInformation لكن المعلومات تُخزن في كتالوج المستند بدلًا من قاموس معلومات المستند. وينبغي تخزين البيانات الوصفية في قاموس معلومات المستند باستخدام SetCustomInformation، بينما ينبغي تخزين المحتوى الخاص أو المعلومات البنيوية في كتالوج المستند باستخدام هذه الدالة
لا يمكن أن يكون المفتاح مفتاحًا نظاميًا للكتالوج تديره المكتبة أو مواصفة PDF. تشمل الأسماء المحجوزة Type وVersion وExtensions وPages وPageLabels وNames وDests وViewerPreferences وOpenAction وAA وAcroForm وMetadata وStructTreeRoot وMarkInfo وLang وSpiderInfo وOutputIntents وPieceInfo وOCProperties وPerms وLegal وRequirements وCollection وNeedsRendering
الصيغة
Delphi
Function TPDFlib.SetCatalogInformation(Const Key, NewValue: WideString): Integer;
ActiveX
Function PDFlib::SetCatalogInformation(Key As String, NewValue As String) As Long
DLL
int DLSetCatalogInformation(int InstanceID, const wchar_t * Key, const wchar_t * NewValue);
المعاملات
| Key | اسم المفتاح المطلوب ضبطه. ويجب أن يحمل هذا المفتاح بادئة خاصة خصصت لك من Adobe لتجنب التعارض مع البرامج الأخرى |
|---|---|
| NewValue | القيمة الجديدة للمفتاح المحدد |
قيم الإرجاع
| 0 | تعذّر ضبط المفتاح المحدد، وقد يكون مفتاحًا نظاميًا |
|---|---|
| 1 | تم ضبط قيمة المفتاح المحدد بنجاح |