AddLinkToImportDataA
Annotációk és hivatkozások, Űrlapmezők és AcroForms
Leírás
A záró A az ANSI (char) DLL-belépési pontot jelöli; az ActiveX/COM felület csak az Unicode változatot teszi elérhetővé. Viselkedése megegyezik az AddLinkToImportData függvényével, a karakterláncargumentumokat pedig az aktuális SetAnsiMode kódlap használatával értelmezi
Kattintható aktívterület-téglalapot ad a kijelölt oldalhoz, amely aktiváláskor PDF importálási adatműveletet indít. Az importálási adatművelet egy lemezen lévő Forms Data Format (FDF) fájlból tölti ki a dokumentum's AcroForm mezőit. A műveletet az ISO 32000-1 §12.6.4.8, 198. táblázat határozza meg
Jellemző használat: “Mintaadatok újratöltése” vagy “Alapértelmezések visszaállítása” hivatkozás interaktív űrlapon, ahol az FDF fájl a PDF mellett található, és a kanonikus mezőértékeket tartalmazza
A hotspot szegélyszínének módosításához használja a SetAnnotBorderColor függvényt
Szintaxis
Delphi
Function DLAddLinkToImportDataA(InstanceID: Integer; Left, Top, Width, Height: Double; FileName: PAnsiChar; Options: Integer): Integer;
DLL
int DLAddLinkToImportDataA(int InstanceID, double Left, double Top, double Width, double Height, const char * FileName, 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 |
| FileName | Az FDF-fájl elérési útja, amelyből az űrlapmezők kitöltődnek A fordított perjelek perjelekre alakulnak az ISO 32000-1 §7.11.2.1 szerinti PDF-kanonikus elérésiút-formában A fájlnak nem kell a PDF létrehozásakor léteznie, de megtekintéskor jelen kell lennie a művelet sikeréhez |
| Options | A hivatkozás megjelenését vezérlő bitmaszk. A 0. bit (1 érték): keretet rajzol a hotspot téglalap köré. Az 1–3. bitek választják ki a kattintási kiemelési módot (2 = Invert, 4 = Outline, 8 = Push); ha nincs kiemelési bit beállítva, alapértelmezésként az Invert használatos. Ugyanez a konvenció érvényes az AddLinkToWeb / AddLinkToHideField metódusokra |
Megjegyzések
PDF/A esetén NEM megengedett, mert a művelet külső erőforrásra hivatkozik, PDF/A módban a függvény csendesen 0-t ad vissza és nem ad hozzá annotációt, PDF 1.4 vagy újabb szükséges