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