HPDFXFABuildButtonAppearance

Unit: HPDFXFAHeadless

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

Prepara uma aparência real de pushbutton usando os mesmos consumers de caption, estado, fontes e layout da criação automática de XFA headless; Text é UTF-8, Style são os metadados emitidos pelo callback de layout do XFA, e Width/Height são pontos físicos do PDF

TrueTypeFont fornece o programa real default; Options.CaptionFontFamilies fornece programas reais adicionais regular, bold, italic e bold-italic, com seus rótulos declarados

FirstObjectNumber precisa ser positivo e deixar espaço para todos os números de objetos gerados consecutivos; o bundle retornado é dono dos objetos nativos alcançáveis e das raízes separadas de propriedades do widget e fonte default

A factory nunca muda um documento do chamador nem grava em um stream do chamador; as checagens de fontes, glyphs, entrada, objetos, bytes serializados e cancelamento se aplicam durante a preparação

Com ResolvedCaptionRuns nil, o caminho existente de família configurada é preservado; o override opcional suporta um catálogo de fontes instaladas resolvido separadamente, sem substituir o texto ou a formatação autorada

Um override não vazio exige o payload atual de caption rich e contagem, texto, estilo, tamanho, cor, underline, strikeout, fronteira de parágrafo, alinhamento e FontFamilyCandidates ordered exatamente correspondentes; apenas FontFamily pode mudar para um rótulo configurado

O fallback compartilhado de fontes então escolhe uma família real que cubra o grapheme completo através de todos os estilos participantes; programas bold ou italic ausentes nunca são sintetizados

Metadados de captions normal/down/rollover, captions explicitamente vazias, captions hidden e o comportamento normal de reserva zero seguem a semântica de captions de pushbutton