AddLinkToEmbeddedPDFA
التعليقات التوضيحية وروابط النقاط الفعالة
الوصف
الحرف المُلحق A يُشير إلى نقطة دخول ANSI (char) في DLL؛ بينما تكشف واجهة ActiveX/COM الشكل Unicode فقط. السلوك مطابق لـ AddLinkToEmbeddedPDF وتُفسَّر وسائط السلاسل النصية باستخدام صفحة الرموز الحالية لـ SetAnsiMode
يضيف تعليقًا توضيحيًا من نوع نص حر إلى الصفحة المحددة. إذا حُدد إطار و/أو تعبئة بالمعامل Options فتُجلب الإعدادات من لون الخط الحالي ولون التعبئة وعرض الخط وإعدادات تنقيط القلم. استخدم المعامل Transparency لضبط إعدادات الشفافية لتعليقات النص الحر. والدالة SetTransparency لا تعمل مع التعليقات التوضيحية
وسم لغة BCP 47، مثل "en-US" و"fr" و"zh-TW". يجب أن يكون غير فارغ
الصيغة
Delphi
Function DLAddLinkToEmbeddedPDFA(InstanceID: Integer; Left, Top, Width, Height: Double; EmbeddedFileName: PAnsiChar; TargetPage, NewWindow, Options: Integer): Integer;
DLL
int DLAddLinkToEmbeddedPDFA(int InstanceID, double Left, double Top, double Width, double Height, const char * EmbeddedFileName, int TargetPage, int NewWindow, int Options);
المعاملات
| Left, Top, Width, Height | موضع وحجم منطقة النقطة الساخنة على الصفحة المحددة |
|---|---|
| EmbeddedFileName | اسم الملف المضمّن في شجرة أسماء EmbeddedFiles للمستند، كما مرر إلى EmbedFile (مثل "report.pdf") |
| TargetPage | الصفحة في المستند المضمّن المطلوب القفز إليها ويبدأ العد من 1 |
| NewWindow | 1 = محاذاة رأسية علوية |
| Options | 1 = مطالبة العارض بفتح المستند المضمّن في نافذة جديدة، 0 = الافتراضي لدى العارض |
قيم الإرجاع
| 0 | تعذّرت إضافة الارتباط (اسم فارغ أو صفحة غير صالحة) |
|---|---|
| 1 | Success |