Aparências de formulários na ABI nativa do Linux

hpdf_document_execute_json_v1 preenche campos AcroForm carregados através de forms.fill, gerando por default as aparências normais correspondentes e retendo as revisões originais do PDF, senhas, dicionário de segurança e document IDs

{"schemaVersion":1,"type":"forms.fill","fields":[
  {"name":"Notes","value":"First line Ω\nSecond café","fontSize":13},
  {"name":"Combo","value":"two"},
  {"name":"Colors","values":["blue","red"]},
  {"name":"Check","checked":true},
  {"name":"Radio","checked":true,"onState":"B"},
  {"name":"Submit","caption":"Send Ω"}
]}

Valores de campos e aparências

Campos de texto aceitam value ou richTextRuns tipados; um value fornecido junto de richTextRuns precisa corresponder exatamente ao texto simples derivado, incluindo separadores de parágrafos CR

Aparências simples respeitam as configurações herdadas de multiline, comb, alinhamento e rotação, e embutem a fonte TrueType Unicode selecionada; runs estilizados carregam estilo, tamanho, cor, alinhamento, quebras de parágrafos e decorações explícitos de fonte

Campos de texto password mascaram suas aparências e mapeamentos de glyphs com um bullet por Unicode scalar, retendo o valor realmente armazenado do campo e a criptografia original; campos de seleção de arquivo exibem seu caminho Unicode literal sem abrir o arquivo selecionado

Campos choice aceitam uma string value ou um array values completo, nunca ambos; export values são mapeados para o texto de display das opções, seleções múltiplas são ordenadas pelo índice da opção, e um array vazio limpa a seleção

Checkboxes e grupos de radio exigem checked Boolean; onState tem default Yes e seleciona o widget de radio correspondente quando fornecido explicitamente, enquanto limpar atualiza tanto o campo quanto os estados dos widgets

Push buttons exigem caption, que é pintada com a fonte Unicode embutida selecionada

forms.read inclui o array values completo de todo campo choice, incluindo um array vazio após a limpeza; o membro escalar value permanece disponível

Para campos rich, forms.read também retorna a string XHTML richText armazenada; substituições comuns de valores sincronizam o RV, e runs estilizados exigem geração de aparências

Opções e publicação

Cada edição aceita fontFamily (default DejaVu Sans), fontSize (12), padding (2), characterSpacing (0), wordSpacing (0) e paintWhiteBackground (true)

Edições rich tipadas também podem usar arrays fontFamilies e seleção de família por run, retendo o comportamento original de família única quando o array está ausente

Edições de texto podem definir explicitamente appearance:false para atualizações somente de valor; edições de choice e botões exigem geração de aparências

Campos desconhecidos, edições duplicadas, seleções inválidas, valores comb excessivos, parâmetros malformados, cancelamento, esgotamento de recursos e callbacks com falha deixam o documento carregado atual inalterado; a saída é preparada antes de qualquer callback de publicação binária rodar

O resultado da operação contém updated e a lista atual de campos; descubra os tipos de aparências suportados pelo array de capability formAppearances

A aceitação da C ABI nativa gera saídas reais de formulários plaintext e AES R5/R6; checagens independentes de pypdf e MuPDF inspecionam índices de seleção, estados de widgets, fontes embutidas, valores Unicode, criptografia e pixels reais de aparências

C ABI nativa do Linux · Workflows de assinatura · Plano de entrega restante