SetOutlineRemoteDestination

Osnovy

Popis

Nastaví položku osnovy (záložku) tak, aby po kliknutí otevřela jiné PDF

Lze zadat číslo otevírané stránky a různé hodnoty rozměrů/pozic

Poznámka: protože velikost stránek cílového dokumentu není známa, všechny pozice se udávají v bodech měřených od levého dolního rohu otevírané stránky

Syntaxe

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

Parametry

OutlineID

ID osnovy vrácené funkcí NewOutline. Alternativně lze platné ID osnovy získat funkcí GetOutlineID

FileName

Název PDF dokumentu, který se má otevřít po kliknutí na osnovu. Musí mít specifický formát. Zpětná lomítka se mají převést na normální lomítka a jednotka, existuje-li, se zadává jen jako písmeno jednotky mezi lomítky bez dvojtečky. Soubor "c:\my documents\hello.pdf" se například zadává jako "/c/my documents/hello.pdf". Relativní cesty jsou platné, včetně cest s operátorem ".." pro o úroveň výš

OpenPage

Číslo stránky, na kterou se má skočit při otevření cílového dokumentu. První stránka má index nula (0)

Zoom

Procento přiblížení použité při otevření dokumentu, platné hodnoty od 0 do 6400. Používá se jen pro DestType = 1, u ostatních DestType se nastavuje na 0

DestType

1 = "XYZ" - cílová stránka se umístí do bodu určeného parametry Left a Top. Parametr Zoom určuje procento přiblížení

2 = "Fit" - celá stránka se přiblíží tak, aby se vešla do okna. Ostatní parametry se nepoužívají a měly by být nastaveny na nulu

3 = "FitH" - stránka se přiblíží tak, aby byla vidět celá její šířka. Výška stránky může být větší nebo menší než výška okna. Stránka se umístí na svislou pozici zadanou parametrem Top

4 = "FitV" - stránka se přiblíží tak, aby byla vidět celá její výška. Šířka stránky může být větší nebo menší než šířka okna. Stránka se umístí na vodorovnou pozici zadanou parametrem Left

5 = "FitR" - stránka se přiblíží tak, aby byl vidět určitý obdélník na stránce. Parametry Left, Top, Right a Bottom určují obdélníkovou oblast na stránce

6 = "FitB" - stránka se přiblíží tak, aby byl vidět její ohraničující obdélník (bounding box)

7 = "FitBH" - stránka se svisle umístí na pozici zadanou parametrem Top. Přiblíží se tak, aby byla vidět celá šířka jejího ohraničujícího obdélníku

8 = "FitBV" - stránka se vodorovně umístí na pozici zadanou parametrem Left. Přiblíží se jen tolik, aby se celá výška ohraničujícího obdélníku vešla do okna

PntLeft

Vodorovná pozice používaná pro DestType = 1, 4, 5 a 8. Pozice se zadává v bodech měřených od levého dolního rohu stránky cílového dokumentu

PntTop

Svislá pozice používaná pro DestType = 1, 3, 5 a 7. Pozice se zadává v bodech měřených od levého dolního rohu stránky cílového dokumentu

PntRight

Vodorovná pozice pravé hrany obdélníku. Používá se pro DestType = 5. Pozice se zadává v bodech měřených od levého dolního rohu stránky cílového dokumentu

PntBottom

Vodorovná pozice dolní hrany obdélníku. Používá se pro DestType = 5. Pozice se zadává v bodech měřených od levého dolního rohu stránky cílového dokumentu

NewWindow

0 = Nahradit aktuální dokument cílovým dokumentem

1 = Otevřít cílový dokument v novém okně, pokud uživatel v PDF prohlížeči nezvolil jinou volbu

Návratové hodnoty