AddLinkToImportData

Adnotacje i odnośniki aktywnych obszarów, pola formularza i AcroForms

Opis

Dodaje klikalny prostokąt hotspotu na wybranej stronie, który po aktywacji wyzwala akcję importu danych PDF. Akcja importu danych wypełnia pola AcroForm dokumentu z pliku Forms Data Format (FDF) na dysku. Akcja jest zdefiniowana w ISO 32000-1 §12.6.4.8, Table 198.

Typowe użycie: link “Załaduj dane przykładowe” albo “Przywróć wartości domyślne” w formularzu interaktywnym, gdzie plik FDF jest dołączony do PDF i przechowuje kanoniczne wartości pól.

Kolor obramowania hotspotu zmień funkcją SetAnnotBorderColor.

Składnia

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);

Parametry

Left	Współrzędna pozioma lewej krawędzi prostokąta aktywnego obszaru
Top	Współrzędna pionowa górnej krawędzi prostokąta aktywnego obszaru
Width	Szerokość prostokąta aktywnego obszaru
Height	Wysokość prostokąta aktywnego obszaru
FileName	Ścieżka do pliku FDF, z którego zostaną wypełnione pola formularza. Ukośniki wsteczne są konwertowane na ukośniki zwykłe zgodnie z kanoniczną postacią ścieżki PDF wg ISO 32000-1 §7.11.2.1. Plik nie musi istnieć w momencie tworzenia pliku PDF, ale musi być dostępny w momencie wyświetlania, aby akcja się powiodła.
Options	Maska bitowa sterująca wyglądem odnośnika. Bit 0 (wartość 1): rysuj obramowanie wokół prostokąta aktywnego obszaru. Bity 1–3 wybierają tryb wyróżnienia po kliknięciu (2 = Invert, 4 = Outline, 8 = Push); gdy żaden bit wyróżnienia nie jest ustawiony, domyślnie używane jest Invert. Ta sama konwencja co w AddLinkToWeb / AddLinkToHideField.

Uwagi

Tryby PDF/A i PDF/X-6 odrzucają akcje ImportData i zwracają 0 bez dodawania adnotacji; wymagany jest PDF 1.4 lub nowszy