ZPLToolkit

^FO

Origem do CampoPreview: parcial

Posiciona o canto superior esquerdo do próximo campo. É o comando que você mais vai usar.

Sintaxe

^FOx,y,z

Parâmetros

ParâmetroDescrição e valores aceitosSe omitido
xDistância da borda esquerda da etiqueta, em pontos.0 to 32000 dots from the left edge0
yDistância da borda superior da etiqueta, em pontos.0 to 32000 dots from the top edge0
zJustificação do campo. Exige firmware V60.14.x ou mais recente.0 left, 1 right, 2 autoLast ^FW value, otherwise 0

Como funciona

^FO define onde o próximo campo começa, em pontos, medidos a partir da origem da etiqueta. A coordenada é o canto superior esquerdo do campo: o texto desce e vai para a direita a partir dela, e o mesmo vale para código de barras e box.

As coordenadas são sempre em pontos, então o mesmo ^FO50,50 cai em um lugar físico diferente numa impressora de 203 e numa de 300 dpi. Ao migrar um template entre resoluções, cada coordenada precisa ser multiplicada pela razão entre elas.

^FO vale até o campo ser fechado com ^FS. O comando irmão ^FT posiciona pela linha de base do texto em vez do canto superior esquerdo — normalmente é o que você quer quando está alinhando textos de tamanhos diferentes.

Exemplo

ZPL
^XA
^FO50,50^A0N,40,40^FDLeft^FS
^FO50,120^A0N,40,40^FDBelow^FS
^XZ

Renderizando…

Dois campos no mesmo x, com 70 pontos de distância vertical.
Abrir no visualizador

O que o preview deste site faz com ele

A posição é reproduzida exatamente. O parâmetro de justificação z é lido mas não aplicado, então campos justificados à direita ou automáticos aparecem alinhados à esquerda.

Erros comuns

  • Tratar as coordenadas como milímetros. São pontos — divida por 8 para ter milímetros a 203 dpi.
  • Posicionar um campo fora do ^PW ou do ^LL. Ele é cortado sem aviso, então o campo simplesmente some.
  • Usar ^FO para alinhar textos de tamanhos diferentes. Os topos ficam alinhados, as linhas de base não; use ^FT para isso.

Veja também