SetOutlineRemoteDestinationA

Outlines

Beschrijving

Het achtervoegsel A duidt het ANSI-toegangspunt (char) van de DLL aan; het ActiveX/COM-oppervlak stelt alleen de Unicode-vorm beschikbaar. Het gedrag is identiek aan SetOutlineRemoteDestination en tekenreeksargumenten worden geïnterpreteerd met behulp van de huidige SetAnsiMode-codetabel

Stelt het outline-item (bookmark) zo in dat er een andere PDF wordt geopend wanneer erop wordt geklikt

Het nummer van de openingspagina en diverse waarden voor grootte/positie kunnen worden opgegeven

Opmerking: omdat de paginagrootte van het doeldocument onbekend is, worden alle posities in punten opgegeven, gemeten vanaf de linkerbenedenhoek van de openingspagina

Syntaxis

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

Syntaxis

OutlineID

De ID van de outline zoals geretourneerd door de functie NewOutline. Gebruik eventueel de functie GetOutlineID om een geldige outline-ID op te halen

FileName

De bestandsnaam van het PDF-document dat wordt geopend wanneer op de outline wordt geklikt. Dit moet in een specifiek formaat. Backslashes worden forward slashes en de schijf, indien aanwezig, wordt alleen als schijfletter tussen forward slashes opgegeven, zonder dubbele punt. Het bestand "c:\my documents\hello.pdf" wordt bijvoorbeeld opgegeven als "/c/my documents/hello.pdf". Relatieve padnamen zijn geldig, inclusief paden met de operator ".." om een map omhoog te gaan

OpenPage

Het paginanummer waarnaar wordt gesprongen wanneer het doeldocument wordt geopend. De eerste pagina heeft index nul (0)

Zoom

Het zoomepercentage dat bij het openen van het document wordt gebruikt, geldige waarden van 0 tot 6400. Alleen gebruikt bij DestType = 1; zet deze op 0 bij andere DestTypes

DestType

1 = "XYZ" - de doelpagina wordt gepositioneerd op het punt dat door de parameters Left en Top wordt opgegeven. De parameter Zoom geeft het zoomepercentage

2 = "Fit" - de hele pagina wordt ingezoomd zodat deze in het venster past. De overige parameters worden niet gebruikt en moeten op nul worden gezet

3 = "FitH" - de pagina wordt ingezoomd zodat de volledige breedte zichtbaar is. De hoogte van de pagina kan groter of kleiner zijn dan de hoogte van het venster. De pagina wordt op de verticale positie geplaatst die de parameter Top opgeeft

4 = "FitV" - de pagina wordt ingezoomd zodat de volledige hoogte zichtbaar is. De breedte van de pagina kan groter of kleiner zijn dan de breedte van het venster. De pagina wordt op de horizontale positie geplaatst die de parameter Left opgeeft

5 = "FitR" - de pagina wordt ingezoomd zodat een bepaalde rechthoek op de pagina zichtbaar is. De parameters Left, Top, Right en Bottom bepalen het rechthoekige gebied op de pagina

6 = "FitB" - de pagina wordt ingezoomd zodat de bounding box zichtbaar is

7 = "FitBH" - de pagina wordt verticaal gepositioneerd op de positie die de parameter Top opgeeft. De pagina wordt ingezoomd zodat de volledige breedte van de bounding box zichtbaar is

8 = "FitBV" - de pagina wordt op de horizontale positie geplaatst die de parameter Left opgeeft. De pagina wordt precies ver genoeng ingezoomd om de volledige hoogte van de bounding box in het venster te passen

PntLeft

De horizontale positie die wordt gebruikt door DestType = 1, 4, 5 en 8. De positie wordt in punten opgegeven, gemeten vanaf de linkerbenedenhoek van de pagina van het doeldocument

PntTop

De verticale positie die wordt gebruikt door DestType = 1, 3, 5 en 7. De positie wordt in punten opgegeven, gemeten vanaf de linkerbenedenhoek van de pagina van het doeldocument

PntRight

De horizontale positie van de rechterrand van de rechthoek. Wordt gebruikt door DestType = 5. De positie wordt in punten opgegeven, gemeten vanaf de linkerbenedenhoek van de pagina van het doeldocument

PntBottom

De horizontale positie van de onderkant van de rechthoek. Wordt gebruikt door DestType = 5. De positie wordt in punten opgegeven, gemeten vanaf de linkerbenedenhoek van de pagina van het doeldocument

NewWindow

0 = Het huidige document vervangen door het doeldocument

1 = Het doeldocument in een nieuw venster openen, tenzij de gebruiker in de PDF-viewer een andere voorkeur heeft ingesteld

Retourwaarden