Captions e estados automáticos de push buttons no XFA

HPDFXFAWriteHeadlessPDF cria widgets nativos reais de push buttons a partir do layout XFA, incluindo captions efetivas escalares ou XHTML, programas de fontes fornecidos, visibilidade, flags readonly e metadados de highlight interativos

Cada widget tem FT Btn, a flag Ff de pushbutton, uma aparência normal explícita e uma caption MK.CA Unicode derivada do seu conteúdo realmente renderizado; um botão não vira um campo de entrada de texto e nenhum campo PDF placeholder é exigido

Uma caption normal visível também retém uma entrada DA cujo alias de fonte resolve pelo AcroForm.DR para uma fonte Type0 real de caption normal; nenhuma fonte placeholder vazia é embutida por compatibilidade

Conteúdo e layout de captions

Tamanho, weight, posture, typeface e cor da fonte de captions escalares, mais estilos inline XHTML e baselines mistas, usam o decoder nativo existente de rich text e o builder de aparências

CaptionFontFamilies fornece programas reais regular, bold, italic e bold-italic e famílias nomeadas; faces nunca são sintetizadas e programas de fontes não são descobertos nem baixados

Texto somente whitespace entre elementos inline XHTML é retido, de modo que palavras adjacentes com estilos diferentes preservem seus separadores autorados

Conteúdo de caption ausente retém o fallback existente do nome do campo, enquanto conteúdo explicitamente vazio fica em branco, e captions escalares não vazias preservam espaços autorados no início e no fim; captions hidden, inactive e invisible não pintam texto e não serializam caption visível regenerável

Margens de campos e captions, placement da caption, reserva e alinhamento de parágrafos determinam a região real da caption; reserva ausente, zero e -1 default do schema usam extensão natural sem wrapping automático, reserva positiva permite wrapping, e placement inline ignora a reserva

Limites fixos de campos clipam captions grandes demais; quebras de parágrafos explícitas permanecem ativas, e overlays efetivos por instância retêm irmãos de template inalterados

Highlight e aparências de estados

Highlight XFAResultado PDF nativo
inverted ou ausenteH I com AP.N normal; o reader aplica o tratamento de ativação invertido
noneH N com AP.N normal
outlineH O com AP.N normal; o reader aplica o tratamento de ativação por frame
pushH P com Forms reais AP.N normal, AP.D down e AP.R rollover; a caption down é deslocada para representar a depressão

No modo push, items escalares chamados down e rollover fornecem as captions respectivas e os metadados MK.AC ou MK.RC; um item de estado ausente usa a caption normal, enquanto um item explicitamente vazio dá um estado em branco

Items alternativos não afetam os demais modos de highlight, e cada estado gerado retém sua própria aparência real e grafo de fontes fornecidas

Transações e limites

Mudanças reais de eventos por instância repetida podem ser salvas como XDP, recarregadas e consumidas pelo criador; leitura imediata, overlay e substituição do payload inteiro, isolamento da primeira instância e rollback de eventos com falha permanecem operações nativas do runtime

Nós e bytes da origem, programas de fontes, glyph units, objetos e bytes candidatos são delimitados; cancelamento e falhas de preparação preservam os bytes, comprimento e posição do stream do chamador

A gravação final no stream do chamador é a fronteira de commit; uma exceção disparada por aquele stream durante a gravação pode deixar uma escrita parcial e não é apresentada como um destino não seekable revertido

Este consumer cria estados salvos de aparências de widgets; execução posterior de scripts XFA pelo reader ou reconstrução de aparências, conteúdo de items alternativos rich, ícones de botões, mídia externa e rendering de XML estrangeiro arbitrário permanecem capabilities separadas

Os mapeamentos de highlight e reserva de captions seguem as semânticas de botões do XFA 3.3 e captions

Metadados do emitter · Captions rich booleanas · Criação automática nativa de XFA