AddRelativeLinkToFileExA

Annotations and hotspot links

Mô tả

Hậu tố A là entry point DLL ANSI (char); mặt ActiveX/COM chỉ phơi dạng Unicode. Hành vi giống hệt AddRelativeLinkToFileEx và các tham số chuỗi được diễn giải theo code page hiện tại của SetAnsiMode

Thêm hình chữ nhật hotspot bấm được vào trang đang chọn, link bằng relative path tới một trang và vị trí cụ thể trong tài liệu PDF khác. Dùng hàm SetAnnotBorderColor để đổi màu viền hotspot

Link tới tài liệu đích chỉ qua tên file, tức là kích thước trang của tài liệu đích không được biết trước, nên các tham số DestLeft, DestTop, DestRight và DestBottom luôn tính bằng point, đo từ góc dưới bên trái MediaBox của trang đích

Cú pháp

Delphi

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

DLL

int DLAddRelativeLinkToFileExA(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);

Tham số

Left

Tọa độ ngang của cạnh trái hình chữ nhật hotspot

Top

Tọa độ dọc của cạnh trên hình chữ nhật hotspot

Width

Chiều rộng của hình chữ nhật hotspot

Height

Chiều cao của hình chữ nhật hotspot

FileName

Đường dẫn tuyệt đối đầy đủ và tên file của tài liệu PDF cần link tới, sẽ được chuyển thành relative path

DestPage

Trang trong tài liệu đích cần link tới

NewWindow

0 = Đóng tài liệu hiện tại rồi mở tài liệu mới

1 = Mở tài liệu hiện tại trong một cửa sổ mới

Options

Chỉ định kiểu hiển thị của link:

0 = No border

1 = Draw a border

Tỷ lệ zoom (phần trăm) cho destination object, giá trị hợp lệ từ 0 đến 6400. Chỉ dùng cho DestType = 1, các DestType khác nên đặt bằng 0

Zoom

DestType

1 = "XYZ" - trang đích được định vị tại điểm xác định bởi tham số Left và Top. Tham số Zoom chỉ định tỷ lệ zoom (phần trăm)

2 = "Fit" - toàn trang được zoom để vừa cửa sổ. Các tham số khác đều không dùng và nên đặt bằng 0

3 = "FitH" - trang được zoom sao cho toàn bộ chiều rộng trang hiển thị hết. Chiều cao trang có thể lớn hơn hoặc nhỏ hơn chiều cao cửa sổ. Trang được định vị theo vị trí dọc do tham số Top chỉ định

4 = "FitV" - trang được zoom sao cho toàn bộ chiều cao trang hiển thị hết. Chiều rộng trang có thể lớn hơn hoặc nhỏ hơn chiều rộng cửa sổ. Trang được định vị theo vị trí ngang do tham số Left chỉ định

5 = "FitR" - trang được zoom để hiển thị một hình chữ nhật cụ thể trên trang. Các tham số Left, Top, Right và Bottom xác định vùng chữ nhật đó trên trang

6 = "FitB" - trang được zoom để bounding box của trang hiển thị hết

7 = "FitBH" - trang được định vị dọc theo vị trí do tham số Top chỉ định, đồng thời được zoom sao cho toàn bộ chiều rộng bounding box của trang hiển thị hết

8 = "FitBV" - trang được định vị theo vị trí ngang do tham số Left chỉ định, đồng thời được zoom vừa đủ để toàn bộ chiều cao bounding box nằm gọn trong cửa sổ

DestLeft

Vị trí ngang, dùng cho DestType = 1, 4, 5 và 8

DestTop

Vị trí dọc, dùng cho DestType = 1, 3, 5 và 7

DestRight

Vị trí ngang của cạnh phải hình chữ nhật. Dùng cho DestType = 5

DestBottom

Vị trí ngang của cạnh dưới hình chữ nhật. Dùng cho 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,