AddFileAttachmentA
خصائص المستند
الوصف
تشير اللاحقة A إلى نقطة دخول DLL بصيغة ANSI (char)؛ وتبقى واجهة ActiveX/COM مكشوفةً بالصيغة Unicode فقط. والسلوك مطابق لـ AddFileAttachment وتُفسر وسائط السلاسل بصفحة شيفرة SetAnsiMode الحالية
يسجل ملفًا مضمّنًا قائمًا كمرفق على مستوى المستند في عارض PDF. وتعرض القارئات التي تتيح لوحة المرفقات العنوان المزود وتفتح الملف المضمّن المشار إليه عندما يحدده المستخدم
استدعِ AddEmbeddedFile أولًا لنسخ بايتات الملف إلى PDF والحصول على EmbeddedFileID. ثم ينشئ AddLinkToEmbeddedFile التعليق التوضيحي على الصفحة، ويكتب عنوان المرفق ومحتويات النافذة المنبثقة، ويوجه التعليق التوضيحي إلى مواصفة الملف المضمّن تلك
سلوك إصدار PDF: تُصدر AddEmbeddedFile قواميس تدفق الملف المضمّن ومواصفة الملف، وهي تتطلب PDF 1.3. وتسجيل الملف في شجرة الأسماء /Names /EmbeddedFiles على مستوى المستند يتطلب PDF 1.4. إذا كان إصدار المستند الحالي أقل ولم يكن إصدار الحفظ مقفلًا، فترفع AddFileAttachment المستند تلقائيًا إلى PDF 1.4 وتسجل /EmbeddedFiles name tree في AutoBumpedFeatures. وإذا قفل المستدعي إصدار حفظ أقل، فترفض بوابة التوافق الحفظ مع LastErrorCode 602
الصيغة
Delphi
Function DLAddFileAttachmentA(InstanceID: Integer; Title: PAnsiChar; EmbeddedFileID: Integer): Integer;DLL
int DLAddFileAttachmentA(int InstanceID, const char * Title, int EmbeddedFileID);المعاملات
| Title | اسم المرفق الظاهر في العارض والمستخدم كمفتاح في شجرة الأسماء /EmbeddedFiles. يجب ألا يكون فارغًا |
|---|---|
| EmbeddedFileID | قيمة تُرجعها AddEmbeddedFile |
قيم الإرجاع
| 0 | قيمة EmbeddedFileID غير صالحة، أو العنوان فارغ، أو لا يوجد مستند نشط |
|---|---|
| 1 | سُجل الملف المضمّن كمرفق على مستوى المستند |
ملاحظات
تنشئ هذه الدالة مدخل قائمة مرفقات على مستوى المستند. لوضع أيقونة أو نقطة ساخنة قابلة للنقر على صفحة، استخدم AddLinkToEmbeddedFile بدلًا من ذلك. ولضم ملف وتسجيله في استدعاء واحد، استخدم EmbedFile
انظر أيضا
AddEmbeddedFile, AddLinkToEmbeddedFile, EmbedFile, SetEmbeddedFileAFRelationship, EmbeddedFileCount