AddLinkToNamedDestination

Annotations and hotspot links, Page properties

Mô tả

Thêm hình chữ nhật hotspot bấm được vào trang đang chọn, nhảy tới một named destination trong cùng tài liệu PDF. Hãy dùng NewDestination và NewNamedDestination đăng ký đích trước, rồi tạo hotspot tham chiếu tên destination ổn định đó thay vì nhân bản số trang và destination array

Dùng hàm SetAnnotBorderColor để đổi màu viền của hotspot

Cú pháp

Delphi

Function TPDFlib.AddLinkToNamedDestination(Left, Top, Width, Height: Double; Const DestName: WideString; Options: Integer): Integer;

DLL

int DLAddLinkToNamedDestination(int InstanceID, double Left, double Top, double Width, double Height, const wchar_t * DestName, int Options);

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
DestName	Named destination cần nhảy tới. Tên này phải đã có trong name tree của tài liệu, thường tạo qua NewNamedDestination
Options	Bitmask điều khiển hiển thị link. Bit 0 (giá trị 1): vẽ viền quanh hình chữ nhật hotspot. Các bit 1–3 chọn chế độ highlight khi click (2 = Invert, 4 = Outline, 8 = Push); khi không bật bit highlight nào, mặc định là Invert

Giá trị trả về

0	DestName rỗng hoặc không tạo được link
1	Đã thêm link named-destination vào trang đang chọn

Remarks

Chú thích link ghi một hành động GoTo với điểm đến là chuỗi named destination. Nhờ đó hotspot vẫn ổn định khi trang được chèn hoặc di chuyển sau khi named destination đã tạo