AddRelativeLinkToFileEx
คำอธิบายประกอบและลิงก์ฮอตสปอต
คำอธิบาย
เพิ่มสี่เหลี่ยม hotspot คลิกได้ลงหน้าที่เลือกอยู่ โดยลิงก์ผ่าน relative path ไปยังหน้าและตำแหน่งที่ระบุในเอกสาร PDF อื่น ใช้ฟังก์ชัน SetAnnotBorderColor เปลี่ยนสีเส้นขอบของ hotspot
ลิงก์ไปเอกสารเป้าหมายอ้างผ่านชื่อไฟล์เท่านั้น แปลว่าไม่รู้ขนาดหน้าของเอกสารเป้าหมาย พารามิเตอร์ 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
พิกัดแนวนอนของขอบซ้ายของสี่เหลี่ยม hotspot
Top
พิกัดแนวตั้งของขอบบนของสี่เหลี่ยม hotspot
Width
ความกว้างของสี่เหลี่ยม hotspot
Height
ความสูงของสี่เหลี่ยม hotspot
FileName
พาธสัมบูรณ์เต็มและชื่อไฟล์ของเอกสาร PDF ปลายทาง ระบบจะแปลงเป็น relative path ให้
DestPage
หน้าในเอกสารปลายทางที่จะลิงก์ไป
NewWindow
0 = ปิดเอกสารปัจจุบันแล้วเปิดเอกสารใหม่
1 = เปิดเอกสารปัจจุบันในหน้าต่างใหม่
Options
กำหนดรูปลักษณ์ของลิงก์:
0 = No border
1 = Draw a border
เปอร์เซ็นต์ซูมสำหรับวัตถุปลายทาง ค่าที่ใช้ได้ 0 ถึง 6400 ใช้เฉพาะ DestType = 1 นอกนั้นตั้งเป็น 0
Zoom
DestType
1 = "XYZ" - วางหน้าเป้าหมายที่จุดที่กำหนดด้วยพารามิเตอร์ Left และ Top ส่วนพารามิเตอร์ Zoom กำหนดเปอร์เซ็นต์การซูม
2 = "Fit" - ซูมให้ทั้งหน้าพอดีหน้าต่าง พารามิเตอร์อื่นไม่ถูกใช้และควรตั้งเป็นศูนย์
3 = "FitH" - ซูมให้เห็นความกว้างทั้งหมดของหน้า ความสูงของหน้าจะมากหรือน้อยกว่าความสูงหน้าต่างก็ได้ หน้าถูกวางที่ตำแหน่งแนวตั้งที่กำหนดด้วยพารามิเตอร์ Top
4 = "FitV" - ซูมให้เห็นความสูงทั้งหมดของหน้า ความกว้างของหน้าจะมากหรือน้อยกว่าความกว้างหน้าต่างก็ได้ หน้าถูกวางที่ตำแหน่งแนวนอนที่กำหนดด้วยพารามิเตอร์ Left
5 = "FitR" - ซูมให้เห็นสี่เหลี่ยมบริเวณหนึ่งบนหน้า พารามิเตอร์ Left, Top, Right และ Bottom กำหนดพื้นที่สี่เหลี่ยมบนหน้านั้น
6 = "FitB" - ซูมให้เห็นกรอบ bounding box ของหน้า
7 = "FitBH" - วางหน้าในแนวตั้งที่ตำแหน่งที่กำหนดด้วยพารามิเตอร์ Top แล้วซูมให้เห็นความกว้างทั้งหมดของ bounding box ของหน้า
8 = "FitBV" - วางหน้าที่ตำแหน่งแนวนอนที่กำหนดด้วยพารามิเตอร์ Left แล้วซูมพอดีๆ ให้ความสูงทั้งหมดของ bounding box ลงในหน้าต่าง
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,