AddLinkToNamedAction
Annotationer og hotspotlinks, sideegenskaber
Beskrivelse
Tilføjer et klikbart hotspot-rektangel på den valgte side, som udløser en navngivet PDF-handling, når det aktiveres. Navngivne handlinger er fremviserstyrede navigationskommandoer, der er defineret i ISO 32000-1 §12.6.4.11, Table 194. De fire understøttede standardnavne er NextPage, PrevPage, FirstPage og LastPage. I modsætning til AddLinkToPage kræves der ikke et eksplicit destinationssidenummer — fremviseren fortolker kommandoen under kørsel.
Typisk brug: navigationsknapper (Next / Previous / Home / End) i et sidehoved eller en sidefod, hvor destinationen er relativ til den side, fremviseren aktuelt viser
Brug funktionen SetAnnotBorderColor til at ændre farven på hotspot-kanten.
Syntaks
Delphi
Function TPDFlib.AddLinkToNamedAction(Left, Top, Width, Height: Double; NamedActionType: Integer; Options: Integer): Integer;DLL
int DLAddLinkToNamedAction(int InstanceID, double Left, double Top, double Width, double Height, int NamedActionType, int Options);Parametre
| Left | Den vandrette koordinat for hotspot-rektanglets venstre kant |
|---|---|
| Top | Den lodrette koordinat for hotspot-rektanglets øverste kant |
| Width | Bredden af hotspot-rektanglet |
| Height | Højden af hotspot-rektanglet |
| NamedActionType | Vælger den navngivne handling, der skal udløses: 0 = NextPage, 1 = PrevPage, 2 = FirstPage, 3 = LastPage. Værdier uden for dette interval falder tilbage til NextPage, så skriveren altid udsender et specifikationskompatibelt /N-navn |
| Options | Bitmaske, der styrer linkets udseende. Bit 0 (værdi 1): tegner en kant omkring hotspotrektanglet. Bit 1–3 vælger fremhævningstilstanden ved klik (2 = Invert, 4 = Outline, 8 = Push); når ingen fremhævningsbit er angivet, bruges Invert som standard. Samme konvention som AddLinkToWeb / AddLinkToPage |
Bemærkninger
Annoteringen er PDF/A-kompatibel, fordi der ikke refereres til nogen ekstern ressource. PDF 1.1 eller nyere er påkrævet.