AddLinkToImportData

Анотації та активні зони-посилання, поля форм та AcroForms

Опис

Додає до вибраної сторінки прямокутник активної зони, який під час активації запускає дію імпорту даних PDF. Дія імпорту даних заповнює поля AcroForm документа з файлу Forms Data Format (FDF) на диску. Дію визначено в ISO 32000-1 §12.6.4.8, Table 198Типове застосування: посилання “Перезавантажити зразкові дані” або “Скинути до типових” в інтерактивній формі, де файл FDF постачається разом із PDF і містить еталонні значення полівЩоб змінити колір рамки активної зони, скористайтеся функцією SetAnnotBorderColor

Типове застосування — посилання “Reload sample data” чи “Reset to defaults” в інтерактивній формі, коли файл FDF постачається разом із PDF і містить канонічні значення полів

Синтаксис

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	Горизонтальна координата лівого краю прямокутника активної зони
Top	Вертикальна координата верхнього краю прямокутника активної зони
Width	Ширина прямокутника активної зони
Height	Висота прямокутника активної зони
FileName	Шлях до файлу FDF, з якого буде заповнено поля форми. Зворотні скісні риски перетворюються на прямі відповідно до канонічної форми шляху PDF за ISO 32000-1 §7.11.2.1. Файл не мусить існувати під час створення PDF, але має бути присутнім під час перегляду, щоб дія виконалася успішно.
Options	Бітова маска, що керує виглядом посилання. Біт 0 (значення 1): малювати рамку навколо прямокутника активної зони. Біти 1–3 вибирають режим підсвічування при клацанні (2 = Invert, 4 = Outline, 8 = Push); якщо жоден біт підсвічування не задано, типово використовується Invert. Та сама угода, що й у AddLinkToWeb / AddLinkToHideField.

Примітки

Режими PDF/A та PDF/X-6 відхиляють дії ImportData і повертають 0, не додаючи анотацію; потрібен PDF 1.4 або новіший