FormFieldAt vlastnosť

FormFieldAt vyhľadá anotáciu ovládacieho prvku AcroForm, ktorá obsahuje bod (X, Y) v priestore strany, a sprístupní jeho hodnotu ako Unicode reťazec. Súradnice sú v používateľskom priestore PDF, s počiatkom v ľavom dolnom rohu strany a jednotkami v bodoch (1/72 palca). Čítanie vlastnosti vráti aktuálnu hodnotu poľa (/V) dekódovanú na WString; zápis ju aktualizuje a regeneruje streamy vzhľadu, takže nová hodnota sa vykreslí pri ďalšom kreslení.

Vráti prázdny reťazec, keď je Active False, keď dokument nemá AcroForm alebo keď žiaden ovládací prvok nepokrýva súradnicu. Politika zhody zrkadlí FormFieldInfoAt: iba obdĺžniky ovládacích prvkov (bez hit testingu viazaného na vzhľad), pri prekrytí vyhrá najvrchnejší ovládací prvok. Zápisy sú no-ops, keď súradnica mine každý ovládací prvok.

Pre ovládacie prvky zaškrtávacích polí a rádiových tlačidiel sémantika hodnôt nasleduje špecifikáciu PDF — priradenie 'Off' vymaže pole, priradenie hodnoty zodpovedajúcej názvu stavu zapnuté /AP /N ovládacieho prvku (zvyčajne 'Yes' alebo hodnota exportu) ho zaškrtne. Pre textové polia sa všetko, čo priradíte, stane novým obsahom /V. Polia zoznamu / combo prijímajú hodnotu exportu priradenú k jednej z položiek volieb. Ak je typ poľa neistý, najprv použite FormFieldInfoAt na preskúmanie FieldType.

• Zápisy sa aplikujú okamžite, ale na disk sa uložia až nasledujúcim volaním SaveToFile / SaveToStream.
• Pre vymazanie textového poľa nastavte hodnotu na prázdny reťazec; pole zostane viditeľné, ale vykreslí sa bez glyfov.
• Súbežné zápisy cez viacero priradení FormFieldAt / FormField sú bezpečné v sekvencii, ale nikdy nevolajte z vlákien na pozadí — polia formulára PDFium nie sú bezpečné pre vlákna.