NewDestination
Chú thích và liên kết điểm nóng, Quản lý tài liệu
Mô tả
Tạo một đối tượng đích mới có thể dùng với các hàm AddLinkToDestination, GetDestPage, GetDestType hoặc GetDestValue.
Cú pháp
Delphi
Function TPDFlib.NewDestination(DestPage, Zoom, DestType: Integer; Left, Top, Right, Bottom: Double): Integer;
ActiveX
Function PDFlib::NewDestination(DestPage As Long, Zoom As Long, DestType As Long, Left As Double, Top As Double, Right As Double, Bottom As Double) As Long
DLL
int DLNewDestination(int InstanceID, int DestPage, int Zoom, int DestType, double Left, double Top, double Right, double Bottom);
Tham số
| DestPage | Số trang mà destination object này link tới |
|---|---|
| Zoom | 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 |
| 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ổ |
| Left | Vị trí ngang, dùng cho DestType = 1, 4, 5 và 8 |
| Top | Vị trí dọc, dùng cho DestType = 1, 3, 5 và 7 Vị trí ngang của cạnh phải hình chữ nhật. Dùng cho DestType = 5 |
| Right | |
| Bottom | Vị trí ngang của cạnh dưới hình chữ nhật. Dùng cho DestType = 5 |
Giá trị trả về
| 0 | Tham số DestPage không hợp lệ Một giá trị DestID |
|---|---|
| Non-zero |