ZPLToolkit

^FX

ComentárioPreview: exato

Adiciona um comentário que não é impresso. Prático para dividir o template em seções, com uma armadilha em relação ao circunflexo.

Sintaxe

^FXc

Parâmetros

ParâmetroDescrição e valores aceitosSe omitido
cO texto do comentário. Não pode conter ^ nem ~, que encerrariam o comentário.Any text without ^ or ~None

Como funciona

^FX marca um texto que a impressora ignora. É a forma padrão de dividir um template longo em seções legíveis — o bloco de endereço, o código de barras, o rodapé — sem afetar a saída.

O comentário termina no próximo ^ ou ~, que normalmente é o comando da linha seguinte, e funciona exatamente como se espera. Isso também significa que um circunflexo dentro do texto do comentário encerra ele antes da hora, e o resto da frase passa a ser executado como comando ZPL.

Um ^FS depois do ^FX é opcional. Os próprios exemplos da Zebra incluem um, e as duas formas são aceitas.

Exemplo

ZPL
^XA
^FX --- Recipient ---
^FO40,40^A0N,35,35^FDJohn Doe^FS
^FX --- Tracking number ---
^BY3
^FO40,110^BCN,70,Y,N,N^FD12345678^FS
^XZ

Renderizando…

Dois comentários dividindo a etiqueta em seções; nenhum dos dois é impresso.
Abrir no visualizador

O que o preview deste site faz com ele

Suportado integralmente: comentários não geram saída. Vale lembrar que um circunflexo dentro do comentário também o encerra na impressora, então o preview vai mostrar o que vier depois sendo executado.

Erros comuns

  • Escrever um circunflexo dentro do comentário, como em '^FX use ^FO aqui'. Tudo depois do circunflexo vira comando.
  • Usar ^FX para guardar dados que você espera recuperar depois. Eles são descartados, não armazenados.
  • Comentários muito longos em impressão de alto volume. Custam tempo de transmissão em links seriais lentos.

Veja também