SetOutlineRemoteDestinationA

大綱

描述

結尾的 A 表示 ANSI（char）DLL 進入點；ActiveX/COM 介面只提供 Unicode 形式。行為與 SetOutlineRemoteDestination 完全相同，字串參數依目前 SetAnsiMode 的字碼頁解讀

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

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

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

語法

Delphi

Function DLSetOutlineRemoteDestinationA(InstanceID, OutlineID: Integer; FileName: PAnsiChar; OpenPage, Zoom, DestType: Integer; PntLeft, PntTop, PntRight, PntBottom: Double; NewWindow: Integer): Integer;

DLL

int DLSetOutlineRemoteDestinationA(int InstanceID, int OutlineID, const char * 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 檢視器中指定了不同的偏好設定

傳回值