^FB
Bloco de CampoPreview: parcialQuebra dados de campo em um bloco de texto com largura fixa, limite de linhas, justificação e recuo pendente opcional.
Sintaxe
^FBa,b,c,d,eParâmetros
| Parâmetro | Descrição e valores aceitos | Se omitido |
|---|---|---|
| a | Largura disponível para cada linha, em pontos. Um valor menor que a largura da fonte não deixa texto imprimível.0 to the label width, in dots | 0 |
| b | Número máximo de linhas impressas.1 to 9999 lines | 1 |
| c | Espaço extra positivo ou sobreposição negativa entre linhas consecutivas, em pontos.-9999 to 9999 dots between lines | 0 |
| d | Alinhamento dentro do bloco. A última linha justificada sai alinhada à esquerda.L left, C centre, R right, J justified | L |
| e | Recuo aplicado à segunda linha e às seguintes, em pontos.0 to 9999 dots hanging indent | 0 |
Como funciona
^FB transforma a próxima string de dados de campo em um bloco de texto. Ele usa a origem, fonte e orientação atuais, separa palavras para caber na largura declarada e inicia cada linha seguinte depois do espaçamento configurado.
O máximo de linhas é um limite real de impressão, não só um recorte. Quando sobra texto, a impressora consolida o restante na última linha visível; um template precisa reservar linhas suficientes antes de chegar à produção.
Os alinhamentos à esquerda, centro, direita e justificado atuam dentro do bloco. O recuo pendente afeta só a segunda linha em diante, útil para endereços e descrições de itens, mas não para um título simples centralizado.
Exemplo
^XA
^PW400
^LL220
^FO40,30^A0N,30,30^FB300,3,6,C,20^FDA field block wraps a short sentence into aligned lines.^FS
^XZRenderizando…
O que o preview deste site faz com ele
A prévia expande o bloco em campos de texto posicionados. A sobra é consolidada na última linha e pode passar da largura do bloco; por isso, o Validador também marca o próprio ^FB quando isso acontece. Blocos rotacionados continuam aproximados.
Erros comuns
- Tratar a largura declarada como garantia de que cada caractere da última linha ficará dentro dela. A consolidação da sobra pode alargar essa linha final.
- Reaproveitar um ^FB para vários campos. ^FS encerra o bloco; cada campo separado precisa do seu próprio ^FB.
- Deixar o limite em uma linha para endereço ou descrição dinâmica. Um valor longo vira uma última linha ilegível em vez de abrir novas linhas.