ZPLToolkit

^XA

Início do FormatoPreview: parcial

Abre um formato de etiqueta. Toda etiqueta ZPL começa com ^XA, e a impressora ignora comandos de campo que chegarem antes dele.

Sintaxe

^XA

Este comando não tem parâmetros.

Como funciona

^XA avisa a impressora de que um novo formato de etiqueta está começando. Não tem parâmetros e precisa ser o primeiro comando da etiqueta. Tudo que estiver entre ^XA e o ^XZ correspondente descreve uma etiqueta.

A impressora acumula os comandos conforme eles chegam e só imprime a etiqueta quando encontra o ^XZ. Um ^XA que nunca é fechado deixa a impressora esperando mais dados — é o motivo mais comum de a etiqueta não sair e a impressora parecer travada.

Você pode enviar várias etiquetas em uma única transmissão repetindo o par ^XA … ^XZ. Cada par é uma etiqueta separada e começa a partir dos padrões salvos da impressora, não do estado que a etiqueta anterior deixou.

Exemplo

ZPL
^XA
^FO40,60^A0N,45,45^FDOne label^FS
^XZ

Renderizando…

Uma etiqueta completa mínima: abre o formato, posiciona um campo, fecha.
Abrir no visualizador

O que o preview deste site faz com ele

O preview trata ^XA como o início do desenho. Ainda não pagina: se você colar vários blocos ^XA … ^XZ, todos são desenhados sobrepostos no mesmo canvas.

Erros comuns

  • Enviar comandos de campo antes do ^XA. A impressora descarta em silêncio, e a etiqueta sai com pedaços faltando sem nenhum erro.
  • Abrir um segundo ^XA sem fechar o primeiro com ^XZ. A impressora trata como erro de sintaxe e o resultado é imprevisível.
  • Achar que as configurações sobrevivem de uma etiqueta para outra. ^CF, ^BY e ^FW voltam ao padrão de fábrica a cada ^XA, a menos que tenham sido salvos com ^JUS.

Veja também