AddLinkToImportData

Annotációk és hotspot-hivatkozások, űrlapmezők és AcroForms

Leírás

Kattintható hotspot téglalapot ad a kijelölt oldalhoz, amely aktiváláskor PDF adatimportáló actiont indít. Az adatimportáló action a dokumentum AcroForm mezőit tölti fel egy lemezen lévő Forms Data Format (FDF) fájlból. Az action az ISO 32000-1 §12.6.4.8, 198. táblázat szerint van definiálva

Tipikus használat: “Mintaadatok újratöltése” vagy “Alapértelmezésekre visszaállítás” hivatkozás interaktív űrlapban, ahol az FDF fájl a PDF mellett utazik, és a kanonikus mezőértékeket tartja

Használd a SetAnnotBorderColor függvényt a hotspot szegély színének megváltoztatására

Szintaxis

Delphi

Function TPDFlib.AddLinkToImportData(Left, Top, Width, Height: Double; Const FileName: WideString; Options: Integer): Integer;

DLL

int DLAddLinkToImportData(int InstanceID, double Left, double Top, double Width, double Height, const wchar_t * FileName, int Options);

Paraméterek

LeftA hotspot-téglalap bal szélének vízszintes koordinátája
TopA hotspot-téglalap felső szélének függőleges koordinátája
WidthA hotspot-téglalap szélessége
HeightA hotspot-téglalap magassága
FileNameAz FDF fájl elérési útvonala, amelyből az űrlapmezők feltöltésre kerülnek. A visszaperjelek perjelekké alakításra kerülnek az ISO 32000-1 §7.11.2.1 szerinti PDF-kanonikus útvonalalaknak megfelelően. A fájlnak nem kell léteznie a PDF létrehozásakor, de a művelet sikeréhez a megtekintéskor jelen kell lennie.
OptionsA hivatkozás megjelenését vezérlő bitmaszk. 0. bit (értéke 1): keret rajzolása a hotspot-téglalap köré. Az 1–3. bit választja ki a kattintás kiemelési módját (2 = Invert, 4 = Outline, 8 = Push); ha nincs kiemelési bit beállítva, alapértelmezés szerint az Invert lép életbe. Ugyanaz a konvenció, mint az AddLinkToWeb / AddLinkToHideField esetén.

Megjegyzések

A PDF/A és PDF/X-6 módok elutasítják az ImportData műveleteket, és annotáció hozzáadása nélkül 0-t adnak vissza; PDF 1.4 vagy újabb szükséges