AddLinkToFileEx

annotationها و hotspot linkها

توضیحات

یک مستطیل نقطهٔ داغ قابل کلیک به صفحهٔ انتخاب‌شده اضافه می‌کند که به صفحه و موقعیت معینی در سند PDF دیگری پیوند می‌خورد؛ برای تغییر رنگ قاب نقطهٔ داغ از تابع SetAnnotBorderColor استفاده کنید

پیوند به سند مقصد فقط از طریق نام فایل است؛ یعنی ابعاد صفحات سند مقصد معلوم نیستند، بنابراین پارامترهای DestLeft، DestTop، DestRight و DestBottom همیشه بر حسب point و اندازه‌گیری‌شده از گوشهٔ پایین-چپ MediaBox صفحهٔ مقصد مشخص می‌شوند

نحو

Delphi

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

ActiveX

Function PDFlib::AddLinkToFileEx(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 DLAddLinkToFileEx(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

مختصات افقی لبه چپ مستطیل hotspot

Top

مختصات عمودی لبهٔ بالایی مستطیل نقطهٔ داغ

Width

عرض مستطیل نقطهٔ داغ

Height

ارتفاع مستطیل نقطهٔ داغ

FileName

مسیر و نام فایل سند PDF که باید به آن پیوند داده شود

DestPage

صفحه‌ای در سند destination که باید به آن پیوند داده شود

NewWindow

0 = سند جاری بسته و سپس سند جدید باز می‌شود

1 = سند جاری در پنجرهٔ جدیدی باز می‌شود

گزینه‌ها

ظاهر پیوند را مشخص می‌کند:

0 = No border

1 = Draw a border

درصد zoom مورد استفاده برای object مقصد؛ مقدارهای معتبر از 0 تا 6400 هستند. فقط برای DestType = 1 استفاده می‌شود و برای سایر DestTypes باید روی 0 تنظیم شود

Zoom

DestType

1 = "XYZ" - صفحهٔ مقصد در نقطه‌ای قرار می‌گیرد که پارامترهای Left و Top مشخص می‌کنند؛ پارامتر Zoom درصد zoom را تعیین می‌کند

2 = "Fit" - کل صفحه طوری zoom می‌شود که در پنجره جا شود؛ از سایر پارامترها استفاده نمی‌شود و باید صفر تنظیم شوند

3 = "FitH" - صفحه چنان zoom می‌شود که تمام عرض آن دیده شود. ارتفاع صفحه ممکن است از ارتفاع پنجره بیشتر یا کمتر باشد. صفحه در موقعیت عمودی تعیین‌شده توسط پارامتر Top قرار می‌گیرد

4 = "FitV" - صفحه طوری zoom می‌شود که کل ارتفاعش دیده شود؛ عرض صفحه می‌تواند از عرض پنجره بیشتر یا کمتر باشد؛ صفحه در موقعیت افقی‌ای قرار می‌گیرد که پارامتر Left مشخص می‌کند

5 = "FitR" - صفحه طوری zoom می‌شود که مستطیل معینی از آن دیده شود؛ پارامترهای Left، Top، Right و Bottom ناحیهٔ مستطیلی روی صفحه را تعریف می‌کنند

6 = "FitB" - صفحه طوری zoom می‌شود که کادر مرزی آن دیده شود

7 = "FitBH" - صفحه به‌صورت عمودی در موقعیت قرار می‌گیرد که پارامتر Top مشخص می‌کند و طوری zoom می‌شود که کل عرض کادر مرزی صفحه دیده شود

8 = "FitBV" - صفحه در موقعیت افقی‌ای قرار می‌گیرد که پارامتر Left مشخص می‌کند و فقط به اندازه‌ای zoom می‌شود که کل ارتفاع کادر مرزی در پنجره جا شود

DestLeft

موقعیت افقی مورد استفاده توسط DestType = 1، 4، 5 و 8

DestTop

موقعیت عمودی مورد استفاده برای DestType = 1، 3، 5 و 7

DestRight

موقعیت افقی لبهٔ راست مستطیل؛ توسط DestType = 5 استفاده می‌شود

DestBottom

موقعیت افقی لبهٔ پایین مستطیل؛ توسط DestType = 5 استفاده می‌شود

double DestLeft, double DestTop, double DestRight, double DestBottom);

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