AddLinkToNamedDestination
Megjegyzések és forrópont-hivatkozások, oldaltulajdonságok
Leírás
Kattintható aktívterület-téglalapot ad a kijelölt oldalhoz, amely ugyanazon PDF-dokumentum elnevezett céljára ugrik. Először a NewDestination és NewNamedDestination segítségével regisztrálja a célt, majd olyan aktív területeket hozzon létre, amelyek az oldal számának és a céltömbnek a megkettőzése helyett a stabil célnévre hivatkoznak
A hotspot szegélyszínének módosításához használja a SetAnnotBorderColor függvényt
Szintaxis
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);
Paraméterek
| Left | Az aktív terület téglalap bal szélének vízszintes koordinátája |
|---|---|
| Top | Az aktív terület téglalap felső szélének függőleges koordinátája |
| Width | Az aktív terület téglalapjának szélessége |
| Height | Az aktív terület téglalapjának magassága |
| DestName | Az átugrandó elnevezett cél, a névnek már léteznie kell a dokumentum névfájában, általában a NewNamedDestination révén |
| Options | A hivatkozás megjelenését szabályozó bitmaszk. A 0. bit (1 érték): szegélyt rajzol a hotspot téglalapja köré. Az 1–3. bitek kattintási kiemelési módot választanak (2 = Invert, 4 = Outline, 8 = Push); kiemelési bit nélkül az Invert az alapértelmezett |
Visszatérési értékek
| 0 | A DestName üres volt, vagy a hivatkozást nem lehetett létrehozni |
|---|---|
| 1 | A névvel ellátott célhelyre mutató hivatkozás hozzá lett adva a kijelölt oldalhoz |
Megjegyzések
A hivatkozási megjegyzés egy GoTo műveletet ír, amelynek célja a névvel ellátott célhely karakterlánca. Ez akkor is stabillá teszi a gyorsgombokat, ha a névvel ellátott célhely létrehozása után oldalakat szúrnak be vagy helyeznek át