HPDFXFAResolveInstalledCaptionFonts

Windows unit: HPDFXFAWindowsFonts

function HPDFXFAResolveInstalledCaptionFonts(const Text: UnicodeString;
  const Style: AnsiString; const RequestedFamily: UnicodeString;
  const Options: TXFAHeadlessPDFOptions;
  out Runs: THPDFHeadlessRichTextRuns): THPDFHeadlessRichTextFontFamilies;

Builds a bounded catalogue from actual installed programs for a template typeface and ordered inline CSS font-family candidates, together with compatible decoded caption runs

Arial is the required actual default family; a missing RequestedFamily or authored CSS label is skipped after a real GDI lookup rather than replaced with a pretend program

The resolver reads the union of styles used by the current runs and template defaults, including regular for default and alternate-state captions; unused italic and bold-italic programs are not loaded

Available families can contain missing styles; the shared appearance fallback chooses one real family covering the entire grapheme across all participating run styles

FontFamilyCandidates preserves authored order while FontFamily names the first configured candidate; pass the returned families as Options.CaptionFontFamilies and the returned Runs as the factory's ResolvedCaptionRuns for a rich caption

Queries are cached within the call and limited to 256 distinct labels; at most sixteen actual families are configured, and all program bytes read count conservatively against Options.MaxFontBytes

Original Options cancellation, XML and code-unit limits apply; a failure clears the out Runs array and returns no catalogue, while normal language exception semantics leave a caller's previous function-result assignment unchanged

This function performs font preparation only and does not change any PDF object graph