ZPLToolkit

^FD

Dados do CampoPreview: exato

Fornece o conteúdo do campo — o texto, o dado do código de barras ou o conteúdo do QR.

Sintaxe

^FDa

Parâmetros

ParâmetroDescrição e valores aceitosSe omitido
aO conteúdo do campo. Termina no próximo ^ ou ~, então esses caracteres precisam ser escapados com ^FH.Up to 3072 bytes of printable dataNone

Como funciona

^FD carrega os dados do campo que está sendo montado. O que a impressora faz com eles depende do comando anterior: depois de um comando de fonte, é texto; depois de ^BC, é o conteúdo do Code 128; depois de ^BQ, é o conteúdo do QR.

Os dados vão do ^FD até o ^FS que fecha o campo. Um acento circunflexo ou um til no meio encerra o campo antes da hora, porque esses caracteres iniciam comandos — é de longe a causa mais comum de etiquetas em que o texto para no meio e coisas estranhas são impressas depois. O ^FH é como se escapa esses caracteres.

O limite prático é de 3072 bytes por campo. Caracteres fora do ASCII puro exigem ^CI28 para selecionar UTF-8 antes, senão as letras acentuadas saem com o glifo errado.

Exemplo

ZPL
^XA
^FO40,50^A0N,40,40^FDHello, label^FS
^XZ

Renderizando…

Um campo de texto: fonte, posição, dados e o separador que fecha.
Abrir no visualizador

O que o preview deste site faz com ele

Suportado integralmente, incluindo os escapes do ^FH. O texto é desenhado com uma fonte de navegador, então a largura dos glifos é próxima, mas não idêntica, à das fontes residentes da impressora.

Erros comuns

  • Um ^ ou ~ literal nos dados — um preço como '100^' ou uma URL com til. Use ^FH e escreva _5E ou _7E.
  • Acentos sem ^CI28. Os bytes chegam à impressora, mas caem em caracteres errados na página de código padrão.
  • Um segundo ^FD antes do ^FS. Só o último vale, então o primeiro campo sai vazio.

Veja também