FormFieldAt Właściwość

Ten wpis API zachowuje identyfikatory, sygnatury, bloki kodu i terminy PDF w oryginalnej postaci.

Odczytuje lub zapisuje wartość pola formularza znajdującego się pod podaną współrzędną strony

FormFieldAt wyszukuje adnotację widgetu AcroForm, która zawiera punkt (X, Y) w przestrzeni strony, i udostępnia jej wartość jako łańcuch Unicode. Współrzędne są podawane w przestrzeni użytkownika PDF, z początkiem w lewym dolnym rogu strony i jednostkami w punktach (1/72 cala). Odczyt właściwości zwraca bieżącą wartość pola (/V) zdekodowaną do WString; zapis aktualizuje pole i ponownie generuje strumienie wyglądu, aby nowa wartość została wyrenderowana przy następnym odrysowaniu

Zwraca pusty łańcuch, gdy Active ma wartość False, gdy dokument nie ma AcroForm albo gdy żaden widget nie obejmuje danej współrzędnej. Zasada dopasowania odpowiada FormFieldInfoAt: tylko prostokąty widgetów (bez testowania trafienia po wyglądzie), a przy nakładaniu wygrywa widget najwyższy. Zapisy nie wykonują nic, gdy współrzędna nie trafia w żaden widget

Dla checkboxów i przycisków radio semantyka wartości jest zgodna ze specyfikacją PDF — przypisanie 'Off' czyści pole, a przypisanie wartości odpowiadającej nazwie stanu on widgetu /AP /N (zwykle 'Yes' albo wartości eksportowej) zaznacza je. W przypadku pól tekstowych wszystko, co przypiszesz, staje się nową zawartością /V. Listy i pola combo akceptują wartość eksportową powiązaną z jedną z pozycji opcji. Jeśli typ pola nie jest pewny, najpierw użyj FormFieldInfoAt, aby sprawdzić FieldType

• Zapisy są stosowane natychmiast, ale trafiają na dysk dopiero przy następnym wywołaniu SaveToFile / SaveToStream
• Aby wyczyścić pole tekstowe, ustaw pusty łańcuch; pole pozostaje widoczne, ale renderuje się bez glifów
• Wiele zapisów przez przypisania FormFieldAt / FormField jest bezpieczne w sekwencji, ale nigdy nie wywołuj ich z wątków pomocniczych — pola formularza PDFium nie są threadsafe

FormFieldInfoAt, HasFormFieldAt, FormField, FormFieldCount