AddLinkToImportData
Анотации и hotspot връзки, Полета на формуляр и AcroForms
Описание
Добавя правоъгълна интерактивна област към избраната страница, която при активиране задейства PDF действие за импортиране на данни. Действието за импортиране на данни попълва полетата AcroForm на документа от файл във формат Forms Data Format (FDF) на диска. Действието е дефинирано в ISO 32000-1 §12.6.4.8, Table 198
Типична употреба: връзка „Reload sample data“ или „Reset to defaults“ в интерактивен формуляр, където FDF файлът се доставя заедно с PDF и съдържа каноничните стойности на полетата
Използвайте функцията SetAnnotBorderColor, за да промените цвета на рамката на hotspot областта
Синтаксис
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);Параметри
| Left | Хоризонталната координата на левия край на правоъгълника на hotspot областта |
|---|---|
| Top | Вертикалната координата на горния край на правоъгълника на hotspot областта |
| Width | Ширината на правоъгълника на hotspot областта |
| Height | Височината на правоъгълника на hotspot областта |
| FileName | Пътят до FDF файла, от който ще бъдат попълнени полетата на формуляра. Обратните наклонени черти се преобразуват във forward-slash по ISO 32000-1 §7.11.2.1 PDF-канонична форма на пътя. Файлът не е нужно да съществува при създаване на PDF, но трябва да е наличен при преглед, за да успее действието |
| Options | Битова маска, която управлява външния вид на връзката. Бит 0 (стойност 1): чертае рамка около правоъгълника на hotspot областта. Битове 1–3 избират режима на подчертаване при щракване (2 = Invert, 4 = Outline, 8 = Push); когато не е зададен бит за подчертаване, по подразбиране се използва Invert. Същата конвенция като AddLinkToWeb / AddLinkToHideField |
Бележки
НЕ е разрешено в PDF/A, защото действието препраща към външен ресурс. Когато документът е в режим PDF/A, функцията безшумно връща 0 и не се добавя анотация. Изисква се PDF 1.4 или по-нова версия