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, Height | De positie en grootte van het hotspotgebied op de geselecteerde pagina |
|---|---|
| EmbeddedFileName | De naam van het ingesloten bestand in de EmbeddedFiles-naamboom van het document, zoals doorgegeven aan EmbedFile (bijvoorbeeld "report.pdf") |
| TargetPage | De pagina (beginnend bij 1) in het ingesloten document waarnaar wordt gesprongen |
| NewWindow | 1 = de viewer vragen het ingesloten document in een nieuw venster te openen, 0 = standaardgedrag van de viewer |
| Options | 1 = teken een rand rond de hotspot, 0 = geen rand |
Retourwaarden
| 0 | De link kon niet worden toegevoegd (lege naam of ongeldige pagina) |
|---|---|
| 1 | Success |