AddImageFromVariant
معالجة الصور
الوصف
يضيف صورة من مصفوفة بايتات من نوع variant إلى المستند المحدد
بمجرد إضافة الصورة إلى المستند يمكن رسمها على أي صفحة عدة مرات دون زيادة إضافية في حجم ملف PDF
أنواع ملفات الصور المدعومة هي: BMP وTIFF وJPEG وPNG وGIF وWMF وEMF
مع صور BMP وTIFF يمكن استدعاء الدالة CompressImages قبل استدعاء هذه الدالة لضغط بيانات الصورة. أما أنواع الصور الأخرى فتُضغط تلقائيًا
الصيغة
ActiveX
Function PDFlib::AddImageFromVariant(SourceData As Variant, Options As Long) As Longالمعاملات
SourceData
متغير variant يحتوي بيانات الصورة
Options
في صور TIFF متعددة الصفحات يحدد هذا المعامل رقم الصفحة المطلوب تحميلها
For PNG images:
0 = الخط متناسب أو متغير العرض 1 = الخط ثابت العرض، فجميع الحروف لها العرض نفسه
1 = إخفاء شريط الأدوات 2 = إخفاء شريط القوائم 3 = إخفاء واجهة مستخدم النافذة 4 = تغيير حجم النافذة إلى حجم الصفحة الأولى 5 = توسيط النافذة 6 = عرض عنوان المستند 7 = وضع الصفحة بعد ملء الشاشة 8 = ترتيب القراءة النصي السائد 9 = حد العرض 10 = حد القص للعرض 11 = حد العرض للطباعة 12 = حد القص للطباعة 13 = حوار الطباعة الافتراضي: التحجيم 14 = حوار الطباعة الافتراضي: الوجهان 15 = حوار الطباعة الافتراضي: صينية ورق تلقائية 16 = حوار الطباعة الافتراضي: عدد النسخ
101 إلى 104 = يسار وأعلى وعرض وارتفاع الخلية 105 = حجم النص 106 = المركّب الأحمر أو السماوي للون الخلفية 107 = المركّب الأخضر أو الأرجواني للون الخلفية 108 = المركّب الأزرق أو الأصفر للون الخلفية 109 = المركّب الأسود للون الخلفية 110 = المركّب الأحمر أو السماوي للون النص 111 = المركّب الأخضر أو الأرجواني للون النص 112 = المركّب الأزرق أو الأصفر للون النص 113 = المركّب الأسود للون النص 114 إلى 117 = المركّب الأحمر أو السماوي لحدود اليسار والأعلى واليمين والأسفل 118 إلى 121 = المركّب الأخضر أو الأرجواني لحدود اليسار والأعلى واليمين والأسفل 122 إلى 125 = المركّب الأزرق أو الأصفر لحدود اليسار والأعلى واليمين والأسفل 126 إلى 129 = المركّب الأسود لحدود اليسار والأعلى واليمين والأسفل 130 إلى 133 = الحشو للحافة الموافقة لحدود اليسار والأعلى واليمين والأسفل 134 إلى 137 = عرض حدود اليسار والأعلى واليمين والأسفل
2 = تخزين البيانات في كتالوج المستند
2 قاموس القياس نظام إحداثيات جغرافي مكاني (GEO)
3 = تحميل الصورة (بتقييد الصورة إلى 8 بت/قناة)
4 = تحميل قناة ألفا (بتقييدها إلى 8 بت/قناة)
400 = نوع الصورة (راجع ImageType) للقيم 401 = العرض بالبكسلات 402 = الارتفاع بالبكسلات 403 = البتات لكل بكسل 404 = نوع فضاء اللون 405 = معرّف الصورة (سيكون 0 إذا كانت صورة Inline)
لأنواع الصور الأخرى ينبغي ضبط هذا المعامل على 0
سيؤدي ضبط Options على -1 إلى فرض تحميل صور TIFF وEMF وWMF باستخدام مكتبة رسومات GDI+. ويمكن أيضًا تحميل صور TIFF متعددة الصفحات باستخدام GDI+ بتعيين معامل Options على -PageNumber (مثلًا -3 للصفحة 3)
قيم الإرجاع
| 0 | تعذّرت إضافة الصورة |
|---|---|
| Non-zero | أُضيفت الصورة بنجاح. هذا هو معرّف الصورة الجديدة |