AddLinkToResetFormA
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 AddLinkToResetForm, 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ę resetowania formularza PDF. Akcja resetowania formularza przywraca polom AcroForm ich wartości domyślne bez konieczności użycia JavaScript
Użyj FieldNames, aby ograniczyć pola objęte akcją resetowania. Pozostaw FieldNames puste, aby przeglądarka zresetowała wszystkie odpowiednie pola
Aby zmienić kolor obramowania obszaru aktywnego, użyj funkcji SetAnnotBorderColor
Składnia
Delphi
Function DLAddLinkToResetFormA(InstanceID: Integer; Left, Top, Width, Height: Double; FieldNames: PAnsiChar; Flags, Options: Integer): Integer;DLL
int DLAddLinkToResetFormA(int InstanceID, double Left, double Top, double Width, double Height, 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 |
| 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 resetowania formularza PDF zapisywane w pozycji /Flags akcji. Przekaż 0, aby użyć zachowania domyślnego. Standardowe przeglądarki używają bitów flag razem z /Fields, aby ustalić, czy lista ma charakter włączający, czy wyłączający |
| 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 albo prostokąt jest nieprawidłowy |
|---|---|
| 1 | Dodano adnotację łącza i akcję resetowania formularza |
Uwagi
Tryb PDF/A blokuje tę akcję, ponieważ interaktywne akcje formularzy nie nadają się do zgodności archiwalnej. Funkcja wymaga PDF 1.2 lub nowszego