AddLinkToNamedDestination
Annotations and hotspot links, Page properties
Beskrivelse
Legger til et klikkbart hotspot-rektangel på den valgte siden som hopper til en navngitt destinasjon i samme PDF-dokument. Bruk NewDestination og NewNamedDestination til å registrere målet først, og opprett deretter hotspots som refererer til det stabile destinasjonsnavnet i stedet for å duplisere et sidenummer og en destinasjonsmatrise
Bruk SetAnnotBorderColor-funksjonen for å endre fargen på hotspot-kanten
Syntaks
Delphi
Function TPDFlib.AddLinkToNamedDestination(Left, Top, Width, Height: Double; Const DestName: WideString; Options: Integer): Integer;
DLL
int DLAddLinkToNamedDestination(int InstanceID, double Left, double Top, double Width, double Height, const wchar_t * DestName, int Options);
Parametere
| Left | Den horisontale koordinaten for venstre kant av det aktive rektanglet |
|---|---|
| Top | Den vertikale koordinaten for øvre kant av det aktive rektanglet |
| Width | Bredden på det aktive rektanglet |
| Height | Høyden på det aktive rektanglet |
| DestName | Den navngitte destinasjonen som skal hoppes til. Navnet skal allerede finnes i dokumentets navnetre, normalt via NewNamedDestination |
| Options | Bitmaske som styrer lenkeutseendet. Bit 0 (verdi 1): tegn en kant rundt hotspot-rektangelet. Bit 1–3 velger klikkuthevingsmodus (2 = Invert, 4 = Outline, 8 = Push); når ingen uthevingsbit er satt, brukes Invert som standard |
Returverdier
| 0 | DestName var tom, eller lenken kunne ikke opprettes |
|---|---|
| 1 | Lenken til den navngitte destinasjonen ble lagt til den valgte siden |
Merknader
Lenkeannotasjonen skriver en GoTo-handling hvis destinasjon er navngitt destinasjon-strengen. Dette holder hotspots stabile når sider settes inn eller flyttes etter at den navngitte destinasjonen er opprettet