AddLinkToFileExA

annotationها و hotspot linkها

توضیحات

حرف A در انتهای نام، entry point مربوط به DLL از نوع ANSI (char) را نشان می‌دهد؛ سطح ActiveX/COM فقط فرم Unicode را ارائه می‌کند. رفتار با AddLinkToFileEx یکسان است و آرگومان‌های رشته‌ای با استفاده از code page فعلی SetAnsiMode تفسیر می‌شوند

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

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

نحو

Delphi

Function DLAddLinkToFileExA(InstanceID: Integer; Left, Top, Width, Height: Double; FileName: PAnsiChar; DestPage, NewWindow, Options, Zoom, DestType: Integer; DestLeft, DestTop, DestRight, DestBottom: Double): Integer;

DLL

int DLAddLinkToFileExA(int InstanceID, double Left, double Top, double Width, double Height, const char * 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,