AddLinkToNamedDestinationA

Anteckningar och hotspot-länkar, Sidegenskaper

Beskrivning

Det avslutande A anger DLL-ingångspunkten för ANSI (char); ActiveX/COM-ytan exponerar endast Unicode-formen. Beteendet är identiskt med AddLinkToNamedDestination och strängargument tolkas med den aktuella kodtabellen i SetAnsiMode

Lägger till en klickbar hotspot-rektangel på den valda sidan som hoppar till ett namngivet mål i samma PDF-dokument. Använd NewDestination och NewNamedDestination för att först registrera målet och skapa sedan hotspots som refererar till det stabila målnamnet i stället för att duplicera ett sidnummer och en destinationsarray

Använd funktionen SetAnnotBorderColor för att ändra färgen på hotspot-ramen

Syntax

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

Parametrar

LeftDen horisontella koordinaten för hotspot-rektangelns vänstra kant
TopDen övre kanten på hotspot-rektangeln
WidthHotspot-rektangelns bredd
HeightHotspot-rektangelns höjd
DestNameDet namngivna mål som ska öppnas. Namnet bör redan finnas i dokumentets namnträd, normalt via NewNamedDestination
OptionsBitmask som styr länkens utseende. Bit 0 (värde 1): rita en ram runt hotspot-rektangeln. Bitarna 1–3 väljer klickets markeringsläge (2 = Invert, 4 = Outline, 8 = Push); om ingen markeringsbit är satt används Invert som standard

Returvärden

0DestName var tomt eller så kunde länken inte skapas
1Namngiven-destination-länken lades till på den valda sidan

Se även

Länkannoteringen skriver en GoTo-åtgärd vars mål är den namngivna målsträngen. Det håller hotspots stabila när sidor infogas eller flyttas efter att det namngivna målet har skapats