AddFileAttachment

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

الوصف

يسجل ملفًا مضمّنًا قائمًا كمرفق على مستوى المستند في عارض 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 TPDFlib.AddFileAttachment(Const Title: WideString; EmbeddedFileID: Integer): Integer;

ActiveX

Function PDFlib::AddFileAttachment(Title As String, EmbeddedFileID As Long) As Long

DLL

int DLAddFileAttachment(int InstanceID, const wchar_t * Title, int EmbeddedFileID);

المعاملات

قيم الإرجاع

ملاحظات

تنشئ هذه الدالة مدخل قائمة مرفقات على مستوى المستند. لوضع أيقونة أو نقطة ساخنة قابلة للنقر على صفحة، استخدم AddLinkToEmbeddedFile بدلًا من ذلك. ولضم ملف وتسجيله في استدعاء واحد، استخدم EmbedFile

انظر أيضا

AddEmbeddedFile, AddLinkToEmbeddedFile, EmbedFile, SetEmbeddedFileAFRelationship, EmbeddedFileCount