AddLinkToSubmitFormA
Adnotacje i łącza obszarów aktywnych, Pola formularzy i AcroForms
Opis
Końcowa litera A oznacza punkt wejścia DLL ANSI (char); powierzchnia ActiveX/COM udostępnia wyłącznie postać Unicode. Zachowanie jest identyczne jak w AddLinkToSubmitForm, a argumenty ciągów są interpretowane przy użyciu bieżącej strony kodowej SetAnsiMode
Dodaje do wybranej strony klikalny prostokątny obszar aktywny, który po aktywacji wyzwala akcję PDF przesłania formularza. Akcja przesłania formularza wysyła wartości pól AcroForm do adresu URL lub punktu końcowego przetwarzania formularzy bez potrzeby użycia JavaScript
Użyj FieldNames, aby ograniczyć przesyłane pola. Pozostaw FieldNames puste, aby przeglądarka przesłała wszystkie właściwe pola
Aby zmienić kolor obramowania obszaru aktywnego, użyj funkcji SetAnnotBorderColor
Składnia
Delphi
Function DLAddLinkToSubmitFormA(InstanceID: Integer; Left, Top, Width, Height: Double; URL, FieldNames: PAnsiChar; Flags, Options: Integer): Integer;DLL
int DLAddLinkToSubmitFormA(int InstanceID, double Left, double Top, double Width, double Height, const char * URL, const char * FieldNames, int Flags, int Options);Parametry
| Left | Pozioma współrzędna lewej krawędzi prostokąta obszaru aktywnego |
|---|---|
| Top | Pionowa współrzędna górnej krawędzi prostokąta obszaru aktywnego |
| Width | Szerokość prostokąta obszaru aktywnego |
| Height | Wysokość prostokąta obszaru aktywnego |
| URL | Docelowy adres URL przesyłania zapisany w specyfikacji pliku akcji |
| FieldNames | Opcjonalna lista w pełni kwalifikowanych nazw pól AcroForm rozdzielonych przecinkami, średnikami lub podziałami wiersza. Początkowe i końcowe białe znaki wokół każdej nazwy są usuwane |
| Flags | Flagi akcji przesyłania formularza PDF zapisywane w pozycji /Flags akcji. Przekaż 0, aby użyć domyślnego przesyłania w stylu FDF. Typowe standardowe bity to 4 dla formatu HTML, 32 dla XFDF i 256 dla przesłania pełnego dokumentu PDF |
| Options | Maska bitowa sterująca wyglądem łącza. Bit 0 (wartość 1): narysuj obramowanie wokół prostokąta obszaru aktywnego. Bity 1-3 wybierają tryb wyróżnienia kliknięcia (2 = Invert, 4 = Outline, 8 = Push); gdy nie ustawiono żadnego bitu wyróżnienia, domyślnie używany jest Invert |
Wartości zwracane
| 0 | Akcji nie dodano, ponieważ dokument działa w trybie PDF/A, prostokąt jest nieprawidłowy albo URL jest pusty |
|---|---|
| 1 | Dodano adnotację łącza i akcję przesyłania formularza |
Uwagi
Tryb PDF/A blokuje tę akcję, ponieważ może ona odwoływać się do zewnętrznego celu przesyłania. Funkcja wymaga PDF 1.2 lub nowszego