DASetInformation

خصائص المستند، وظائف الوصول المباشر

الوصف

يضبط القيم في قسم معلومات المستند

قد تكون معلومات قياسية مثل Author وSubject أو معلومات مخصصة

بالنسبة إلى 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 TPDFlib.DASetInformation(FileHandle: Integer; Const Key, NewValue: WideString): Integer;

ActiveX

Function PDFlib::DASetInformation(FileHandle As Long, Key As String, NewValue As String) As Long

DLL

int DLDASetInformation(int InstanceID, int FileHandle, const wchar_t * Key, const wchar_t * NewValue);

المعاملات

FileHandleمقبض تُرجعه الدالات DAOpenFile أو DAOpenFileReadOnly أو DAOpenFromStream
Keyللمعلومات القياسية استخدم "Author" أو "Title" أو "Subject" أو "Keywords" أو "Creator" أو "Producer" أو "CreationDate" أو "ModDate". وللمعلومات المخصصة يمكن استخدام أي سلسلة أخرى
NewValueالقيمة الجديدة للمفتاح المحدد

قيم الإرجاع

0كان قيمة FileHandle المحددة غير صالحة ضُبط مفتاح المعلومات أو حُدث بنجاح
1