THPDFHeadlessDocument.SetTextFieldValueWithAppearance

procedure SetTextFieldValueWithAppearance(FieldIndex: Integer;
  const Text: UnicodeString; const TrueTypeFont: SysUtils.TBytes;
  const Options: THPDFHeadlessTextAppearanceOptions);

Atualiza um campo de texto AcroForm terminal gravável e constrói uma aparência normal explícita para cada widget existente, usando o mesmo grafo de objetos do documento no Linux nativo e no Windows

Os retângulos dos widgets fornecem as dimensões da aparência; o Q herdado do campo fornece alinhamento left, center ou right quando presente, caso contrário o alinhamento das opções se aplica

O perfil suporta texto simples de linha única e multilinha, wrapping medido de palavras com fallback de caracteres, quebras de linha CR/LF, tamanho fixo ou auto-fit, células comb com MaxLen herdado positivo, e rotações de widgets em múltiplos de 90 graus

Scripts complexos, runs bidi, ligaduras e sequências combinantes usam HarfBuzz e FriBidi quando ShapeComplexText está habilitado; texto Unicode direto permanece independente desses runtimes, e glyphs ausentes ou surrogate pairs malformados produzem um diagnóstico de aparência

O wrapping complexo multilinha opera sobre clusters Unicode lógicos antes da reordenação bidi e do reshaping; células comb retêm o perfil direto de um glyph por scalar

Para um campo rich-text existente, este método substitui o conteúdo por um estilo simples e sincroniza V, RV e a aparência de todos os widgets; use SetRichTextFieldValueWithAppearance para fornecer estilos mistos

Campos password geram um bullet por Unicode scalar e retêm o valor real Unicode do campo em V; os mapeamentos de glyphs da aparência e o texto de acessibilidade contêm a máscara, enquanto o valor segue a política de criptografia do documento

Campos password não podem ser campos multiline nem comb; Unicode malformado, caracteres de controle, glyphs de máscara ausentes, cancelamento e esgotamento de recursos preservam o campo original

Campos de seleção de arquivo exibem o caminho Unicode literal como texto comum do campo; esta operação não abre, executa nem anexa o arquivo selecionado

Fontes exigem contornos TrueType nomeados válidos e métricas reais, com flags de embutimento installable ou editable; o embutimento de fonte completa honra permissões no-subsetting e rejeita permissões restritas, preview-and-print, somente bitmap, ausentes e desconhecidas

O método prepara todas as substituições de campos, dicionários de aparências, novos objetos de fontes e Forms e os orçamentos de serialização antes de alterar um campo; falhas de preflight preservam seu valor anterior e links de aparência

Novos objetos pertencem ao documento e são salvos pelo writer incremental delimitado original, incluindo criptografia de novas strings e streams sob a política original AES-256 R5 ou R6

NeedAppearances é limpo depois que aparências explícitas cobrem o campo alterado, a menos que outra edição somente de valor ou um requisito original de aparência não resolvida permaneça

Quando a flag original é true, os demais campos não assinatura a mantêm conservadoramente true até que seus requisitos de aparência sejam satisfeitos; use os métodos separados de choice e botões para regenerar esses campos

Campos read-only, MaxLen, assinaturas existentes, permissões de certificação, permissões AES de form-fill, proteção da origem, cancelamento e políticas de saída atômica permanecem em vigor

Se o documento e as opções de aparência especificarem tokens de cancelamento, precisam ser o mesmo token

Veja THPDFHeadlessTextAppearanceOptions e HPDFBuildHeadlessTextAppearance para o contrato delimitado de fontes e layout