AddRelativeLinkToFileEx

التعليقات التوضيحية وروابط النقاط الفعالة

الوصف

يضيف مستطيل نقطة ساخنة قابلًا للنقر إلى الصفحة المحددة يرتبط بمسار نسبي بصفحة وموضع محددين في مستند PDF آخر

يتم الارتباط بالمستند الهدف عبر اسم الملف فقط، ما يعني أن أبعاد صفحات المستند الهدف غير معروفة، لذا تُحدد المعاملات DestLeft وDestTop وDestRight وDestBottom دائمًا بالنقاط المقاسة من الزاوية السفلية اليسرى لـ MediaBox في الصفحة الوجهة

الصيغة

Delphi

Function TPDFlib.AddRelativeLinkToFileEx(Left, Top, Width, Height: Double; Const FileName: WideString; DestPage: Integer; NewWindow, Options, Zoom, DestType: Integer; DestLeft, DestTop, DestRight, DestBottom: Double): Integer;

ActiveX

Function PDFlib::AddRelativeLinkToFileEx(Left As Double, Top As Double, Width As Double, Height As Double, FileName As String, DestPage As Long, NewWindow As Long, Options As Long, Zoom As Long, DestType As Long, DestLeft As Double, DestTop As Double, DestRight As Double, DestBottom As Double) As Long

DLL

int DLAddRelativeLinkToFileEx(int InstanceID, double Left, double Top, double Width, double Height, const wchar_t * FileName, int DestPage, int NewWindow, int Options, int Zoom, int DestType, double DestLeft, double DestTop, double DestRight, double DestBottom);

المعاملات

Left

الإحداثي الأفقي للحافة اليسرى لمستطيل النقطة الساخنة

Top

الإحداثي الرأسي للحافة العلوية لمستطيل النقطة الساخنة

Width

عرض مستطيل النقطة الساخنة

Height

ارتفاع مستطيل النقطة الساخنة

FileName

المسار المطلق الكامل واسم ملف مستند PDF المطلوب الارتباط به، وسيُحوَّل إلى مسار نسبي

DestPage

الصفحة في المستند الوجهة المطلوب الارتباط بها

NewWindow

0 = إغلاق المستند الحالي ثم فتح المستند الجديد

1 = فتح المستند الحالي في نافذة جديدة

Options

تحدد مظهر الارتباط:

0 = No border

1 = Draw a border

نسبة التكبير المستخدمة لكائن الوجهة، بقيم صالحة من 0 إلى 6400. تُستخدم فقط مع DestType = 1، ويجب تعيينها على 0 لغير ذلك من قيم DestType

Zoom

DestType

1 = "XYZ" - تُوضع الصفحة الهدف عند النقطة المحددة بالمعاملين Left وTop، ويحدد المعامل Zoom نسبة التكبير

2 = "Fit" - تُكبَّر الصفحة كلها لتلائم النافذة. لا يُستخدم أي من المعاملات الأخرى ويجب تعيينها على صفر

3 = "FitH" - تُكبَّر الصفحة بحيث يظهر عرضها بالكامل. قد يكون ارتفاع الصفحة أكبر أو أصغر من ارتفاع النافذة. تُوضع الصفحة عند الموضع الرأسي المحدد بالمعامل Top

4 = "FitV" - تُكبَّر الصفحة بحيث يظهر ارتفاعها بالكامل. قد يكون عرض الصفحة أكبر أو أصغر من عرض النافذة. تُوضع الصفحة عند الموضع الأفقي المحدد بالمعامل Left

5 = "FitR" - تُكبَّر الصفحة بحيث تصبح منطقة مستطيلة معينة عليها مرئية. تحدد المعاملات Left وTop وRight وBottom المنطقة المستطيلة على الصفحة

6 = "FitB" - تُكبَّر الصفحة بحيث يصبح صندوقها المحيط مرئيًا

7 = "FitBH" - تُوضع الصفحة رأسيًا عند الموضع المحدد بالمعامل Top، وتُكبَّر بحيث يظهر عرض الصندوق المحيط للصفحة بالكامل

8 = "FitBV" - تُوضع الصفحة عند الموضع الأفقي المحدد بالمعامل Left، وتُكبَّر بأدنى مقدار يكفي لإدخال ارتفاع الصندوق المحيط بالكامل في النافذة

DestLeft

الموضع الأفقي المستخدم مع DestType = 1 و4 و5 و8

DestTop

الموضع الرأسي المستخدم مع DestType = 1 و3 و5 و7

DestRight

الموضع الأفقي للحافة اليمنى للمستطيل. يُستخدم مع DestType = 5

DestBottom

الموضع الأفقي لأسفل المستطيل. يُستخدم مع DestType = 5

int NewWindow, int Options, int Zoom, int DestType, double DestLeft, double DestTop, double DestRight, double DestBottom);

Height: Double; FileName: WideString; DestPage, NewWindow, Options, Zoom, DestType: Integer; DestLeft, DestTop, DestRight,