AddLinkToNamedAction

Annotaties en hotspotkoppelingen, pagina-eigenschappen

Beschrijving

Voegt een klikbare hotspotrechthoek toe aan de geselecteerde pagina die bij activatie een PDF named action triggert. Named actions zijn door de viewer gestuurde navigatiecommando's, gedefinieerd in ISO 32000-1 §12.6.4.11, Table 194. De vier ondersteunde standaardnamen zijn NextPage, PrevPage, FirstPage en LastPage. Anders dan AddLinkToPage is hier geen expliciet doelpaginanummer nodig — de viewer interpreteert het commando tijdens runtime

Typisch gebruik: navigatiebuttons (Next / Previous / Home / End) in een pagina-kop of voettekst, waarbij de bestemming relatief is aan de pagina die de viewer momenteel toont

Gebruik de functie SetAnnotBorderColor om de kleur van de hotspotrand te wijzigen

Syntaxis

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

Parameters

Left	De horizontale coördinaat van de linkerrand van de hotspot-rechthoek
Top	De verticale coördinaat van de bovenrand van de hotspot-rechthoek
Width	De breedte van de hotspot-rechthoek
Height	De hoogte van de hotspot-rechthoek
NamedActionType	Selecteert de benoemde actie die moet worden geactiveerd: 0 = NextPage, 1 = PrevPage, 2 = FirstPage, 3 = LastPage. Waarden buiten dit bereik vallen terug op NextPage, zodat de writer altijd een /N-naam volgens de specificatie uitvoert.
Options	Bitmask dat het uiterlijk van de koppeling bepaalt. Bit 0 (waarde 1): tekent een rand rond de hotspotrechthoek. Bits 1–3 selecteren de klikhighlightmodus (2 = Invert, 4 = Outline, 8 = Push); als geen highlightbit is ingesteld, wordt Invert als standaard gebruikt. Dezelfde conventie als bij AddLinkToWeb / AddLinkToPage

Opmerkingen

De annotatie is PDF/A-compatibel omdat er geen externe resource wordt gerefereerd. PDF 1.1 of nieuwer is vereist