THPDFWindowsFormDataTransaction.GetPreparedField

procedure GetPreparedField(Index: Integer; out Name, Value: UnicodeString;
  out FieldType: Integer);

Reads one field from the actual separately loaded candidate after successful preparation; Index ranges from zero to PreparedFieldCount minus one

Name and Value are Unicode strings; button values contain their export state names; FieldType is the ordinary loaded form-field type ordinal also used by Windows job fields replies

Button state names decode PDF #xx spelling exactly once before UTF-8 conversion, preserving spaces, Unicode and a literal hash followed by hexadecimal characters

Value follows the ordinary loaded scalar-value accessor; a choice stored as an array has an empty scalar Value, whilst its complete selected values remain in the candidate PDF and are available through form-data export after commit

The method polls cancellation and retains all document ownership inside the transaction; an out-of-range index raises EArgumentException, whilst access without a prepared candidate raises EInvalidOpException

These values describe the prepared candidate before publication; reading them does not mutate the borrowed original document and does not commit the candidate

PreparedFieldCount, FillTypedData, Transaction class