StoreCustomDataFromVariant

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

الوصف

تحفظ هذه الدالة بيانات مخصصة، مقدمةً كمصفوفة بايتات من نوع variant، في PDF تحت اسم مفتاح. ويمكن استرجاع هذه البيانات لاحقًا باستخدام RetrieveCustomDataToVariant. ويمكن ضبط نوع التخزين (سلسلة أو تدفق أو تدفق مضغوط) والموقع (قاموس معلومات المستند أو كتالوج المستند). إذا كان الموقع هو كتالوج المستند فيمكن استخدام أي نوع تخزين، لكن يجب أن يحمل المفتاح بادئة خاصة خصصت لك من Adobe. وإذا كان الموقع هو قاموس معلومات المستند فيمكن استخدام أي مفتاح غير المفاتيح القياسية، لكن السلاسل فقط هي المسموح بها

الصيغة

ActiveX

Function PDFlib::StoreCustomDataFromVariant(Key As String, NewValue As Variant, Location As Long, Options As Long) As Long

المعاملات

المفتاح الذي ستُخزَّن البيانات تحته. إذا كان الموقع هو قاموس معلومات المستند فلا يمكن أن يكون المفتاح "Author" أو "Title" أو "Subject" أو "Keywords" أو "Creator" أو "Producer". ويمكن استخدام أي مفتاح آخر، لكن ينبغي اختيار المفاتيح بعناية بحيث تكون مفهومة للمستخدم. وإذا كان الموقع هو كتالوج المستند فيجب أن يحمل المفتاح بادئة خاصة خصصت لك من Adobe لتجنب التعارض مع البرامج الأخرى

Key

NewValue

مصفوفة بايتات من نوع variant تحتوي البيانات المطلوب تخزينها في PDF

Location

1 = جلب البيانات من قاموس معلومات المستند

‏ 1=يسار 2=أعلى 3=أسفل 4=يمين 5=Zoom القيمة الجديدة لخاصية الوجهة المحددة

Options

0 = إرجاع المصدر الأصلي مع قسم التحديث 1 = إرجاع قسم التحديث فقط 2 = إرجاع سلسلة الإدخال المضبوطة بـ SetAppendInputFromString مع قسم التحديث

1 = فقرة (علامة الفقرة "¶")

‏ 1: FontAscent، 2: FontDescent، 3: FontInternalLeading، 4: FontExternalLeading، 5: EM Square، 6: متوسط عرض المحرف

قيم الإرجاع

0كان معامل Location غير صالح
1خُزنت البيانات المخصصة بنجاح