AddLinkToEmbeddedPDFA

Annotaties en hotspotkoppelingen

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 AddLinkToEmbeddedPDF en tekenreeksargumenten worden geïnterpreteerd met behulp van de huidige SetAnsiMode-codetabel

Voegt een hotspotlink toe aan de geselecteerde pagina die een in het huidige bestand ingesloten PDF-document opent en daar naar een pagina springt. De link bevat een ingesloten go-to-actie (/GoToE) volgens ISO 32000-1 §12.6.4.4: de target-keten noemt het ingesloten bestand (de naam die aan EmbedFile is doorgegeven) in de EmbeddedFiles-naamboom van het document, en de bestemming past de doelpagina in het venster in

Omdat /GoToE is geïntroduceerd met PDF 1.6, verhoogt deze functie de documentversie indien nodig naar 1.6. Gebruik GetAnnotActionInfo om zulke acties terug te lezen: die rapporteert het soort akGoToE samen met de naam van het ingesloten doel, de parent/child-relatie en de /NewWindow-vlag

Syntaxis

Delphi

Function DLAddLinkToEmbeddedPDFA(InstanceID: Integer; Left, Top, Width, Height: Double; EmbeddedFileName: PAnsiChar; TargetPage, NewWindow, Options: Integer): Integer;

DLL

int DLAddLinkToEmbeddedPDFA(int InstanceID, double Left, double Top, double Width, double Height, const char * EmbeddedFileName, int TargetPage, int NewWindow, int Options);

Parameters

Left, Top, Width, HeightDe positie en grootte van het hotspotgebied op de geselecteerde pagina
EmbeddedFileNameDe naam van het ingesloten bestand in de EmbeddedFiles-naamboom van het document, zoals doorgegeven aan EmbedFile (bijvoorbeeld "report.pdf")
TargetPageDe pagina (beginnend bij 1) in het ingesloten document waarnaar wordt gesprongen
NewWindow1 = de viewer vragen het ingesloten document in een nieuw venster te openen, 0 = standaardgedrag van de viewer
Options1 = teken een rand rond de hotspot, 0 = geen rand

Retourwaarden

0De link kon niet worden toegevoegd (lege naam of ongeldige pagina)
1Success