FormFieldAt Proprietà

FormFieldAt cerca l'annotazione widget AcroForm che contiene il punto page-space (X, Y) ed espone il suo valore come stringa Unicode. Le coordinate sono in user space PDF, con l'origine nell'angolo in basso a sinistra della pagina e unità in punti (1/72 di pollice). La lettura della proprietà restituisce il valore corrente del campo (/V) decodificato in WString; la scrittura aggiorna il campo e rigenera gli appearance stream così che il nuovo valore venga renderizzato al prossimo paint

Restituisce una stringa vuota quando Active è False, quando il documento non ha AcroForm, o quando nessun widget copre la coordinata. La politica di match rispecchia FormFieldInfoAt: solo rettangoli widget (niente hit testing legato agli appearance), vince il widget più in alto sulle sovrapposizioni. Le scritture sono no-op quando la coordinata non tocca alcun widget

Per i widget checkbox e radio button la semantica del valore segue la specifica PDF — assegnare 'Off' azzerale il campo, assegnare il valore che corrisponde al nome di stato on /AP /N del widget (comunemente 'Yes' o il valore di export) lo spunta. Per i campi di testo, qualunque cosa assegni diventa il nuovo contenuto /V. Le caselle di riepilogo / combinate accettano il valore di export associato a una delle voci delle opzioni. Usa prima FormFieldInfoAt per ispezionare il FieldType quando il tipo di campo è incerto

• Le scritture vengono applicate subito ma persistite su disco solo dalla successiva chiamata a SaveToFile / SaveToStream
• Per azzerare un campo di testo imposta il valore a una stringa vuota; il campo resta visibile ma viene renderizzato senza glifi
• Le scritture concorrenti tramite più assegnazioni FormFieldAt / FormField sono sicure in sequenza ma non chiamarle mai da thread in background — i campi form PDFium non sono threadsafe