SetCatalogInformationA
خصائص المستند
الوصف
تشير اللاحقة A إلى نقطة دخول DLL بصيغة ANSI (char)؛ وتبقى واجهة ActiveX/COM مكشوفةً بالصيغة Unicode فقط. والسلوك مطابق لـ SetCatalogInformation وتُفسر وسائط السلاسل بصفحة شيفرة SetAnsiMode الحالية
تتيح هذه الدالة تخزين معلومات مخصصة في مستند 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 DLSetCatalogInformationA(InstanceID: Integer; Key, NewValue: PAnsiChar): Integer;
DLL
int DLSetCatalogInformationA(int InstanceID, const char * Key, const char * NewValue);
المعاملات
| Key | اسم المفتاح المطلوب ضبطه. ويجب أن يحمل هذا المفتاح بادئة خاصة خصصت لك من Adobe لتجنب التعارض مع البرامج الأخرى |
|---|---|
| NewValue | القيمة الجديدة للمفتاح المحدد |
قيم الإرجاع
| 0 | تعذّر ضبط المفتاح المحدد، وقد يكون مفتاحًا نظاميًا |
|---|---|
| 1 | تم ضبط قيمة المفتاح المحدد بنجاح |