SetOutlineDestinationFull

Đề cương

Mô tả

Đặt điểm đến của một đề mục (bookmark) tới một vị trí và tỷ lệ zoom cụ thể

Cú pháp

Delphi

Function TPDFlib.SetOutlineDestinationFull(OutlineID, DestPage, Zoom, DestType: Integer; Left, Top, Right, Bottom: Double): Integer;

ActiveX

Function PDFlib::SetOutlineDestinationFull(OutlineID As Long, 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 DLSetOutlineDestinationFull(int InstanceID, int OutlineID, int DestPage, int Zoom, int DestType, double Left, double Top, double Right, double Bottom);

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ệ
DestPage	Số trang mà đề mục này link tới Tỷ lệ zoom (phần trăm) dùng khi mở điểm đến của đề mục, 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ổ Vị trí ngang, dùng cho DestType = 1, 4, 5 và 8
Left
Top	Vị trí dọc, dùng cho DestType = 1, 3, 5 và 7
Right	Vị trí ngang của cạnh phải hình chữ nhật. Dùng cho DestType = 5
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	Không đặt được điểm đến của đề mục. Điều này thường cho biết tham số Zoom hoặc DestType vượt khoảng hợp lệ hoặc OutlineID không hợp lệ
1	Đã đặt điểm đến của đề mục thành công