PDFium Component Docs

FormFieldAt Właściwość

Component: TPdf  ·  Unit: PDFium
Odczytuje lub zapisuje wartość pola formularza znajdującego się pod podaną współrzędną strony

Syntax

property FormFieldAt[X, Y: Single]: WString; // read / write

Description

FormFieldAt wyszukuje adnotację widżetu AcroForm zawierającą punkt przestrzeni strony (X, Y) i udostępnia jego wartość jako ciąg Unicode. Współrzędne są w przestrzeni użytkownika PDF, z początkiem układu w lewym dolnym narożniku 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 regeneruje strumienie wyglądu, więc nowa wartość renderuje się przy następnym odrysowaniu

Zwraca pusty ciąg, gdy Active ma wartość False, gdy dokument nie ma AcroForm albo gdy żaden widżet nie pokrywa współrzędnej. Polityka dopasowania odzwierciedla FormFieldInfoAt: wyłącznie prostokąty widżetów (bez testowania trafień po wyglądzie), a przy nakładaniu wygrywa widżet leżący najwyżej. Zapisy są pustą operacją, gdy współrzędna nie trafia w żaden widżet

Dla widżetów pól wyboru i przycisków radiowych semantyka wartości podąża za specyfikacją PDF — przypisanie 'Off' czyści pole, a przypisanie wartości zgodnej z nazwą stanu włączenia /AP /N widżetu (zazwyczaj 'Yes' albo wartość eksportowa) zaznacza je. Dla pól tekstowych wszystko, co przypiszesz, staje się nową treścią /V. Pola listy i kombi przyjmują wartość eksportową powiązaną z jednym z wpisów opcji. Użyj najpierw FormFieldInfoAt, aby sprawdzić FieldType, gdy typ pola jest niepewny

Remarks

Example

// Toggle a checkbox located at (120, 300) on the current page.
if Pdf1.FormFieldAt[120.0, 300.0] = 'Off' then
  Pdf1.FormFieldAt[120.0, 300.0] := 'Yes'
else
  Pdf1.FormFieldAt[120.0, 300.0] := 'Off';

See Also

FormFieldInfoAt, HasFormFieldAt, FormField, FormFieldCount