SetInformationA

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

الوصف

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

اضبط خصائص المستند المحدد

لخاصيتي CreationDate وModDate (تاريخ التعديل) يجب أن تكون صيغة التاريخ:

D:YYYYMMDDHHmmSSOHH'mm'

where

YYYY shall be the year

MM يجب أن يكون الشهر (01-12) DD يجب أن يكون اليوم (01-31) HH يجب أن تكون الساعة (00-23)

mm يجب أن تكون الدقيقة (00-59) SS يجب أن تكون الثانية (00-59)

O يجب أن تكون علاقة التوقيت المحلي بالتوقيت العالمي (UT) باستخدام أحد المحارف + أو - أو Z

HH متبوعة بعلامة APOSTROPHE (U+0027) (') يجب أن تكون القيمة المطلقة للفرق عن UT بالساعات (00-23)

mm متبوعة بعلامة APOSTROPHE اختيارية (U+0027) (') يجب أن تكون القيمة المطلقة للفرق عن UT بالدقائق (00-59)

الصيغة

Delphi

Function DLSetInformationA(InstanceID, Key: Integer; NewValue: PAnsiChar): Integer;

DLL

int DLSetInformationA(int InstanceID, int Key, const char * NewValue);

المعاملات

Keyالخاصية المطلوب ضبطها: ‏0 = إصدار PDF 1 = المؤلف 2 = العنوان 3 = الموضوع 4 = الكلمات المفتاحية 5 = المنشئ 6 = المنتج 7 = تاريخ الإنشاء 8 = تاريخ التعديل 9 = XMP dc:subject
NewValueالقيمة الجديدة للخاصية المحددة

عندما يكون Key يساوي 0 يختار NewValue إصدار PDF الهدف للحفظ الكامل. ولأهداف PDF‏ 1.3 و1.4 و1.5 و1.6 و1.7 تحافظ SaveToFile وSaveToString وSaveToStream على الملف الصادر ضمن ذلك الإصدار المختار. وإذا ما يزال المستند يحتوي ميزة تتطلب إصدار PDF أحدث يفشل الحفظ وتُرجع LastErrorCode القيمة 602

قيم الإرجاع

0تعذّر ضبط المعلومات المحددة. استخدم الدالة LastErrorCode لمعرفة سبب الفشل
1تم ضبط المعلومات المحددة بنجاح