SetOutlineRemoteDestinationA

Osnovy

Popis

Koncové A označuje vstupní bod ANSI (char) knihovny DLL; rozhraní ActiveX/COM zpřístupňuje pouze formu Unicode. Chování je shodné s SetOutlineRemoteDestination a řetězcové argumenty jsou interpretovány pomocí aktuální znakové stránky nastavené funkcí SetAnsiMode

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

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