FormFieldAt Özellik

FormFieldAt, sayfa-uzayındaki (X, Y) noktasını içeren AcroForm widget annotation'ını bulur ve değerini Unicode string olarak sunar. Koordinatlar PDF user space'tedir; başlangıç noktası sayfanın sol alt köşesidir ve birim point'tir (1/72 inch). Property'yi okumak, geçerli alan değerini (/V) WString'e çözülmüş olarak döndürür; yazmak alanı günceller ve appearance stream'lerini yeniden üretir; böylece yeni değer bir sonraki boyamada işlenir

Active False olduğunda, dokümanda AcroForm yokken veya koordinatı kaplayan bir widget yokken boş string döndürür. Eşleştirme politikası FormFieldInfoAt ile aynıdır: yalnızca widget dikdörtgenleri (appearance'a bağlı hit testi yok) ve örtüşmede en üstteki widget kazanır. Koordinat hiçbir widget'a denk gelmezse yazma işlemleri no-op'tur

Checkbox ve radio button widget'larında değer semantiği PDF spec'ini izler — 'Off' atamak alanı temizler; widget’ın /AP /N açık-durum adıyla eşleşen değeri atamak (genellikle 'Yes' veya export value) işaretler. Metin alanlarında atadığınız her şey yeni /V içeriği olur. List / combo box'lar, seçenek girdilerinden biriyle ilişkili export value'yu kabul eder. Alan türü belirsizse önce FieldType'yı incelemek için FormFieldInfoAt kullanın

• Yazmalar anında uygulanır ama ancak bir sonraki SaveToFile / SaveToStream çağrısıyla diske kalıcılaşır
• Bir metin alanını temizlemek için değere boş string atayın; alan görünür kalır ama glifsiz işlenir
• Çoklu FormFieldAt / FormField atamasıyla eşzamanlı yazmalar sırayla güvenlidir ama bunları arka plan thread'lerinden asla çağırmayın — PDFium form alanları threadsafe değildir