AddLinkToNamedDestinationA

Annotationer og hotspotlinks, sideegenskaber

Beskrivelse

Det afsluttende A angiver DLL-indgangspunktet for ANSI (char); ActiveX/COM-grænsefladen eksponerer kun Unicode-formen. Funktionsmåden er identisk med AddLinkToNamedDestination, og strengargumenter fortolkes med den aktuelle SetAnsiMode-tegntabel

Føjer et klikbart hotspotrektangel til den valgte side, som springer til en navngiven destination i samme PDF-dokument. Brug NewDestination og NewNamedDestination til først at registrere målet, og opret derefter hotspots, der refererer til det stabile destinationsnavn i stedet for at duplikere et sidenummer og destinationsarray

Brug funktionen SetAnnotBorderColor til at ændre farven på hotspot-kanten.

Syntaks

Delphi

Function DLAddLinkToNamedDestinationA(InstanceID: Integer; Left, Top, Width, Height: Double; DestName: PAnsiChar; Options: Integer): Integer;

DLL

int DLAddLinkToNamedDestinationA(int InstanceID, double Left, double Top, double Width, double Height, const char * DestName, 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
DestName	Den navngivne destination, der skal springes til. Navnet skal allerede findes i dokumentets navnetræ, normalt via NewNamedDestination
Options	Bitmaske, der styrer linkets udseende. Bit 0 (værdi 1): tegn en kant omkring hotspot-rektanglet. 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

Returværdier

0	DestName var tomt, eller linket kunne ikke oprettes
1	Linket til den navngivne destination blev føjet til den valgte side

Bemærkninger

Linkannoteringen skriver en GoTo-handling, hvis destination er strengen for den navngivne destination. Dette holder hotspots stabile, når sider indsættes eller flyttes, efter at den navngivne destination er oprettet.