AddLinkToEmbeddedFileA

Document properties, Annotations and hotspot links

الوصف

تشير اللاحقة A إلى نقطة دخول DLL بصيغة ANSI (char)؛ وتبقى واجهة ActiveX/COM مكشوفةً بالصيغة Unicode فقط. والسلوك مطابق لـ AddLinkToEmbeddedFile وتُفسر وسائط السلاسل بصفحة شيفرة SetAnsiMode الحالية

دالة AddFreeTextAnnotationEx إذا أردت ضبط إعدادات الشفافية

يحسب عرض النص المحدد بالاستناد إلى الخط وحجم الخط المختارين

سلوك إصدار PDF: تتطلب تعليقات FileAttachment التوضيحية وتدفقات الملفات المضمّنة إصدار PDF 1.3. ومظهر التعليق التوضيحي الذي تولده هذه الدالة قد يتضمن عتامة التعليق التوضيحي عبر /CA وموارد الشفافية، وهي تتطلب PDF 1.4. إذا كان إصدار المستند الحالي أقل ولم يكن إصدار الحفظ مقفلًا، فترفع AddLinkToEmbeddedFile المستند تلقائيًا إلى PDF 1.4 وتسجل /CA annotation opacity في AutoBumpedFeatures. وإذا قفل المستدعي إصدار حفظ أقل، فترفض بوابة التوافق الحفظ مع LastErrorCode 602

Syntax

Delphi

Function DLAddLinkToEmbeddedFileA(InstanceID: Integer; Left, Top, Width, Height: Double; EmbeddedFileID: Integer; Title, Contents: PAnsiChar; IconType, Transpareny: Integer): Integer;

DLL

int DLAddLinkToEmbeddedFileA(int InstanceID, double Left, double Top, double Width, double Height, int EmbeddedFileID, const char * Title, const char * Contents, int IconType, int Transpareny);

Parameters

Leftالإحداثي الأفقي للحافة اليسرى لمستطيل التعليق التوضيحي
Topالإحداثي الرأسي للحافة العلوية لمستطيل التعليق التوضيحي
Widthعرض مستطيل التعليق التوضيحي
Heightارتفاع مستطيل التعليق التوضيحي
EmbeddedFileIDقيمة تُرجعها AddEmbeddedFile
Titleعنوان المرفق الذي يعرضه عارض PDF
Contentsالنص المعروض في النافذة المنبثقة للتعليق التوضيحي
IconTypeأيقونة التعليق التوضيحي: 0 = PushPin، 1 = صورة قرص، 2 = بلا أيقونة، 3 = رسم بياني، 4 = مشبك ورق، 5 = وسم، 6 = مستطيل أبيض مصمت
Transparencyنسبة الشفافية من 0 إلى 100. الصفر معتم تمامًا؛ والقيمة 100 تجعل الأيقونة غير مرئية

Return values

0قيمة EmbeddedFileID غير صالحة، أو لا توجد صفحة محددة، أو لا يوجد مستند نشط
1أُنشئ التعليق التوضيحي FileAttachment بنجاح

انظر أيضا

AddEmbeddedFile, AddFileAttachment, EmbedFile, SetEmbeddedFileAFRelationship, EmbeddedFileCount