SetOutlineRemoteDestination

大綱

描述

設定大綱項目（書籤）被點擊時開啟另一份 PDF

可指定起始頁碼與各種尺寸/位置值

注意：因為目標文件的頁面尺寸未知，所有位置都以點為單位，從起始頁左下角量起

語法

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);

參數

OutlineID

由 NewOutline 函式傳回的大綱 ID。也可以用 GetOutlineID 函式取得有效的大綱 ID

FileName

點擊大綱時要開啟的 PDF 文件檔名。必須使用特定格式：反斜線要改成斜線，磁碟機（若有的話）只寫磁碟機代號、夾在兩條斜線之間、不帶冒號。例如 "c:\my documents\hello.pdf" 應寫成 "/c/my documents/hello.pdf"。相對路徑有效，包括含 ".." 回上層目錄的路徑

OpenPage

目標文件開啟時要跳到的頁碼。第一頁的索引為零（0）

Zoom

文件開啟時使用的縮放百分比，有效值為 0 到 6400。只在 DestType = 1 時使用，其他 DestType 應設為 0

DestType

1 = "XYZ" - 目標頁面定位到 Left 與 Top 參數指定的點，Zoom 參數指定縮放百分比

2 = "Fit" - 縮放整頁以符合視窗。其他參數都不會使用，應設為零

3 = "FitH" - 縮放頁面讓整個頁寬都可見。頁面高度可能高於或低於視窗高度。頁面垂直定位在 Top 參數指定的位置

4 = "FitV" - 縮放頁面讓整個頁高都可見。頁面寬度可能大於或小於視窗寬度。頁面水平定位在 Left 參數指定的位置

5 = "FitR" - 縮放頁面讓頁面上某個矩形區域可見。Left、Top、Right 與 Bottom 參數定義頁面上的矩形區域

6 = "FitB" - 縮放頁面讓其邊界框可見

7 = "FitBH" - 頁面垂直定位在 Top 參數指定的位置，並縮放讓邊界框的整個頁寬可見

8 = "FitBV" - 頁面水平定位在 Left 參數指定的位置，並縮放到剛好讓邊界框的整個頁高納入視窗

PntLeft

DestType = 1、4、5 與 8 使用的水平位置。位置以點為單位，從目標文件頁面的左下角量起

PntTop

DestType = 1、3、5 與 7 使用的垂直位置。位置以點為單位，從目標文件頁面的左下角量起

PntRight

矩形右緣的水平位置。DestType = 5 時使用。位置以點為單位，從目標文件頁面的左下角量起

PntBottom

矩形底邊的水平位置。DestType = 5 時使用。位置以點為單位，從目標文件頁面的左下角量起

NewWindow

0 = 以目標文件取代目前文件

1 = 在新視窗開啟目標文件，除非使用者在 PDF 檢視器中指定了不同的偏好設定

傳回值