AddLinkToSubmitForm
Adnotacje i łącza aktywne, Pola formularzy i AcroForms
Opis
Dodaje klikalny prostokąt aktywny do wybranej strony, który po aktywacji wyzwala akcję wysyłania formularza PDF; akcja wysyłania formularza przesyła wartości pól AcroForm do adresu URL lub punktu końcowego przetwarzania formularzy bez potrzeby użycia JavaScriptu
Użyj parametru FieldNames, aby ograniczyć przesyłane pola. Pozostaw FieldNames puste, aby przeglądarka przesłała wszystkie odpowiednie pola
Użyj funkcji SetAnnotBorderColor, aby zmienić kolor obramowania obszaru aktywnego
Składnia
Delphi
Function TPDFlib.AddLinkToSubmitForm(Left, Top, Width, Height: Double; Const URL, FieldNames: WideString; Flags, Options: Integer): Integer;DLL
int DLAddLinkToSubmitForm(int InstanceID, double Left, double Top, double Width, double Height, const wchar_t * URL, const wchar_t * FieldNames, int Flags, int Options);Parametry
| Left | Pozioma współrzędna lewej krawędzi prostokąta aktywnego |
|---|---|
| Top | Pionowa współrzędna górnej krawędzi prostokąta aktywnego |
| Width | Szerokość prostokąta aktywnego |
| Height | Wysokość prostokąta aktywnego |
| URL | Docelowy adres URL wysyłania przechowywany w specyfikacji pliku akcji |
| FieldNames | Opcjonalna lista w pełni kwalifikowanych nazw pól AcroForm oddzielonych przecinkami, średnikami lub podziałami wierszy. Wiodące i końcowe białe znaki wokół każdej nazwy są usuwane |
| Flags | Flagi akcji wysyłania formularza PDF zapisywane we wpisie /Flags akcji. Przekaż 0, aby użyć domyślnego trybu przesyłania w formacie FDF. Typowe standardowe bity: 4 dla formatu HTML, 32 dla XFDF, 256 dla przesłania całego dokumentu PDF |
| Options | Maska bitowa kontrolująca wygląd łącza. Bit 0 (wartość 1): rysuje obramowanie wokół prostokąta aktywnego. Bity 1–3 wybierają tryb podświetlenia po kliknięciu (2 = Invert, 4 = Outline, 8 = Push); gdy żaden bit podświetlenia nie jest ustawiony, domyślnie stosowany jest tryb Invert |
Wartości zwracane
| 0 | Akcja nie została dodana, ponieważ dokument jest w trybie PDF/A, prostokąt jest nieprawidłowy lub URL jest pusty |
|---|---|
| 1 | Adnotacja łącza i akcja wysyłania formularza zostały dodane |
Uwagi
Tryb PDF/A blokuje tę akcję, ponieważ może ona odwoływać się do zewnętrznego miejsca docelowego wysyłania. Funkcja wymaga PDF 1.2 lub nowszego