AddLinkToResetForm
Adnotacje i łącza aktywne, Pola formularzy i AcroForms
Opis
Dodaje klikalny prostokąt aktywny do wybranej strony, który po aktywacji wyzwala akcję resetowania formularza PDF; akcja resetowania formularza przywraca pola AcroForm do ich domyślnych wartości bez potrzeby użycia JavaScriptu
Użyj parametru FieldNames, aby ograniczyć pola objęte akcją resetowania. Pozostaw FieldNames puste, aby przeglądarka zresetowała wszystkie odpowiednie pola
Użyj funkcji SetAnnotBorderColor, aby zmienić kolor obramowania obszaru aktywnego
Składnia
Delphi
Function TPDFlib.AddLinkToResetForm(Left, Top, Width, Height: Double; Const FieldNames: WideString; Flags, Options: Integer): Integer;DLL
int DLAddLinkToResetForm(int InstanceID, double Left, double Top, double Width, double Height, 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 |
| 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 resetowania formularza PDF zapisywane we wpisie /Flags akcji. Przekaż 0, aby użyć domyślnego zachowania. Standardowe przeglądarki używają bitów flag wraz z /Fields do ustalenia, czy lista jest inkluzywna czy ekskluzywna |
| 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 lub prostokąt jest nieprawidłowy |
|---|---|
| 1 | Adnotacja łącza i akcja resetowania formularza zostały dodane |
Uwagi
Tryb PDF/A blokuje tę akcję, ponieważ interaktywne akcje formularzy nie są odpowiednie dla zgodności archiwalnej. Funkcja wymaga PDF 1.2 lub nowszego