SetOutlineRemoteDestination

Đề cương

Mô tả

Đặt đề mục (bookmark) mở một PDF khác khi được nhấp

Có thể chỉ định số trang mở đầu cùng nhiều giá trị kích thước/vị trí

Lưu ý: vì không biết kích thước trang của tài liệu đích, mọi vị trí đều tính bằng point, đo từ góc dưới bên trái trang mở

Cú pháp

Delphi

Function TPDFlib.SetOutlineRemoteDestination(OutlineID: Integer; Const FileName: WideString; OpenPage, Zoom, DestType: Integer; PntLeft, PntTop, PntRight, PntBottom: Double; NewWindow: Integer): Integer;

ActiveX

Function PDFlib::SetOutlineRemoteDestination(OutlineID As Long, FileName As String, OpenPage As Long, Zoom As Long, DestType As Long, PntLeft As Double, PntTop As Double, PntRight As Double, PntBottom As Double, NewWindow As Long) As Long

DLL

int DLSetOutlineRemoteDestination(int InstanceID, int OutlineID, const wchar_t * FileName, int OpenPage, int Zoom, int DestType, double PntLeft, double PntTop, double PntRight, double PntBottom, int NewWindow);

Tham số

OutlineID

ID của đề mục do hàm NewOutline trả về. Cách khác, dùng hàm GetOutlineID để lấy một outline ID hợp lệ

FileName

Tên file PDF cần mở khi đề mục được nhấp. Đường dẫn phải theo định dạng đặc biệt: dấu gạch ngược đổi thành dấu gạch xuôi, và ổ đĩa (nếu có) chỉ ghi chữ cái ổ đĩa giữa hai dấu gạch xuôi, không có dấu hai chấm. Ví dụ, file "c:\my documents\hello.pdf" phải ghi là "/c/my documents/hello.pdf". Relative path hợp lệ, kể cả đường dẫn có ".." để đi lên một thư mục

OpenPage

Số trang cần nhảy tới khi tài liệu đích được mở. Trang đầu tiên có chỉ số không (0)

Zoom

Tỷ lệ zoom (phần trăm) dùng khi mở tài liệu, 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

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ổ

PntLeft

Vị trí ngang, dùng cho DestType = 1, 4, 5 và 8. Vị trí tính bằng point, đo từ góc dưới bên trái trang của tài liệu đích

PntTop

Vị trí dọc, dùng cho DestType = 1, 3, 5 và 7. Vị trí tính bằng point, đo từ góc dưới bên trái trang của tài liệu đích

PntRight

Vị trí ngang của cạnh phải hình chữ nhật. Dùng cho DestType = 5. Vị trí tính bằng point, đo từ góc dưới bên trái trang của tài liệu đích

PntBottom

Vị trí ngang của cạnh dưới hình chữ nhật. Dùng cho DestType = 5. Vị trí tính bằng point, đo từ góc dưới bên trái trang của tài liệu đích

NewWindow

0 = Thay tài liệu hiện tại bằng tài liệu đích

1 = Mở tài liệu đích trong cửa sổ mới, trừ khi người dùng đã đặt tùy chọn khác trong PDF viewer

Giá trị trả về