Apariencias de formularios del ABI nativo de Linux

hpdf_document_execute_json_v1 llena los campos AcroForm cargados mediante forms.fill, generando por defecto apariencias normales coincidentes y conservando las revisiones originales del PDF, 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 de fuente, 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 un bullet por 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 arreglo values completo, nunca ambos; los export values se mapean al texto visible de la opción, las selecciones múltiples se ordenan por índice de opción y un arreglo vacío limpia la selección

Los checkboxes y grupos radio exigen checked booleano; onState es 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 embebida seleccionada

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

Para los rich fields, forms.read también devuelve la cadena XHTML richText almacenada; los reemplazos de valor ordinarios sincronizan RV, y los runs con estilo exigen generación de 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 arreglos fontFamilies y selección de familia por run, conservando el comportamiento original de familia única cuando el arreglo está ausente

Las ediciones de texto pueden asignar explícitamente appearance:false para actualizaciones de solo valor; las ediciones de choice y botón exigen generación de apariencia

Los campos desconocidos, las ediciones duplicadas, las selecciones inválidas, los valores comb excesivos, los parámetros malformados, la cancelación, el agotamiento de recursos y los callbacks fallidos dejan el documento cargado actual sin cambios; la salida se prepara antes de que corra cualquier callback de publicación binaria

El resultado de la operación contiene updated y la lista actual de campos; descubre los tipos de apariencia soportados mediante el arreglo de capacidades formAppearances

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

C ABI nativo de Linux · Flujos de firma · Plan de entrega restante