SetCustomInformation
خصائص المستند
الوصف
تُستخدم هذه الدالة لتخزين بيانات وصفية مخصصة في المستند. ويمكن قراءة هذه القيم لاحقًا من المستند بالدالة GetCustomInformation. وتُخزن البيانات في قاموس معلومات المستند. أما المحتوى الخاص أو المعلومات البنيوية فينبغي تخزينه في كتالوج المستند باستخدام الدالة SetCatalogInformation
الصيغة
Delphi
Function TPDFlib.SetCustomInformation(Const Key, NewValue: WideString): Integer;
ActiveX
Function PDFlib::SetCustomInformation(Key As String, NewValue As String) As Long
DLL
int DLSetCustomInformation(int InstanceID, const wchar_t * Key, const wchar_t * NewValue);
المعاملات
| Key | يحدد المفتاح المطلوب ضبطه |
|---|---|
| NewValue | القيمة التي سيُضبط بها المفتاح |
قيم الإرجاع
| 0 | تعذّر ضبط القيمة. لا يمكن أن يكون المعامل Key هو "Producer" أو "Creator" أو "Subject" أو "Title" أو "Keywords" أو "Author". لهذه المفاتيح استخدم الدالة SetInformation |
|---|---|
| 1 | تم ضبط قيمة المفتاح بنجاح |