HPDFXFABuildRadioButtonAppearance

Unit: HPDFXFAHeadless

function HPDFXFABuildRadioButtonAppearance(const Value, Style: AnsiString;
  const Items: TXFAFieldOptions; Width, Height: Double;
  const TrueTypeFont: SysUtils.TBytes; FirstObjectNumber: Integer;
  const Options: TXFAHeadlessPDFOptions;
  const ResolvedCaptionRuns: THPDFHeadlessRichTextRuns = nil): THPDFXFAButtonAppearance;

Prepares one actual radio member appearance using the same native shape, mark, size, border, Unicode caption and font consumers as automatic headless XFA creation

Value and Items contain UTF-8 data; Width and Height are physical PDF points, and Style carries the metadata emitted by the XFA layout callback

Style must include a nonempty radiogrouphex repeat-scope identity and the radiovaluehex selected group value, including an empty encoded value when the group selection is empty

The first item supplies the member export unless buttonexporthex supplies its exact raw value; selection compares that export with the decoded group value, rather than treating a nonempty Value as a Boolean

AP contains exactly Off and the member's selected state; checkbox neutral metadata does not add a third radio state

Reserved, empty and XFAOn-prefixed exports use distinct appearance aliases; an adopting group retains the literal authored exports in its Opt array

TrueTypeFont supplies the actual default font program; Options.CaptionFontFamilies supplies real additional regular, bold, italic and bold-italic programs

The optional ResolvedCaptionRuns has the same exact payload, formatting and ordered candidate validation as HPDFXFABuildButtonAppearance; only the resolved configured family may differ

FirstObjectNumber must be positive and leave room for all consecutive generated object numbers; the returned bundle owns the reachable native graph until objects are detached

Preparation changes no caller document or stream; input, object, glyph, font, serialised-byte and cancellation budgets apply throughout preparation

Properties retains AP, AS, MK, H, DA and Q when generated; it contains no parent, group value, export array, page, rectangle or field identity

The adopting document creates the parent and Kids, links each widget to the correct repeat scope, persists the selected group value and registers Fonts in its AcroForm resources