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تم ضبط قيمة المفتاح المحدد بنجاح