Apariencias de formularios por ABI nativa de Linux

hpdf_document_execute_json_v1 rellena los campos AcroForm cargados mediante forms.fill, generando por defecto apariencias normales coincidentes y conservando las revisiones PDF originales, las contraseñas, el diccionario de seguridad y los 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 y apariencias

Los campos de texto aceptan value o richTextRuns tipados; un value suministrado junto a richTextRuns debe coincidir exactamente con el texto plano derivado, incluidos los separadores de párrafo CR

Las apariencias planas respetan los ajustes heredados de multiline, comb, alineación y rotación e incrustan la fuente Unicode TrueType seleccionada; los runs con estilo llevan estilo, tamaño, color, alineación, saltos de párrafo y decoraciones explícitos

Los campos de texto de contraseña enmascaran sus apariencias y mapeos de glifos con una viñeta por valor escalar Unicode conservando el valor real almacenado del campo y el cifrado original; los campos file-select muestran su ruta Unicode literal sin abrir el archivo seleccionado

Los campos choice aceptan una cadena value o un array values completo, nunca ambos; los valores de exportación se mapean al texto de visualización de la opción, las selecciones múltiples se ordenan por índice de opción y un array vacío limpia la selección

Los checkboxes y grupos radio exigen checked booleano; onState vale Yes por defecto y selecciona el widget radio coincidente cuando se suministra explícitamente, mientras que limpiar actualiza tanto el estado del campo como el del widget

Los push buttons exigen caption, que se pinta con la fuente Unicode incrustada seleccionada

forms.read incluye el array values completo para cada campo choice, incluido un array vacío tras limpiar; el miembro escalar value sigue disponible

Para campos rich, forms.read también devuelve la cadena XHTML richText almacenada; los reemplazos de valor ordinarios sincronizan el RV, y los runs con estilo exigen generar la apariencia

Opciones y publicación

Cada edición acepta fontFamily (por defecto DejaVu Sans), fontSize (12), padding (2), characterSpacing (0), wordSpacing (0) y paintWhiteBackground (true)

Las ediciones rich tipadas también pueden usar arrays fontFamilies y selección de familia por run, conservando el comportamiento original de familia única cuando el array está ausente

Las ediciones de texto pueden establecer appearance:false explícitamente para actualizaciones de solo valor; las ediciones choice y button exigen generar la apariencia

Campos desconocidos, ediciones duplicadas, selecciones inválidas, valores comb excesivos, parámetros mal formados, cancelación, agotamiento de recursos y callbacks fallidos dejan el documento cargado actual sin cambios; la salida se prepara antes de ejecutar cualquier callback de publicación binaria

El resultado de la operación contiene updated y la lista de campos actual; descubre los tipos de apariencia soportados a través del array de capacidades formAppearances

La aceptación de la C ABI nativa genera salidas de formulario reales en texto plano y AES R5/R6; comprobaciones independientes con pypdf y MuPDF inspeccionan índices de selección, estados de widgets, fuentes incrustadas, valores Unicode, cifrado y píxeles reales de la apariencia

C ABI nativa de Linux · Workflows de firma · Plan de entrega restante