ZPLToolkit

^FH

Indicador Hexadecimal de CampoPreview: exato

Permite que o ^FD carregue bytes escritos como _XX — o único jeito de imprimir um ^ ou um ~ literal nos dados.

Sintaxe

^FHa

Parâmetros

ParâmetroDescrição e valores aceitosSe omitido
aO caractere que inicia um escape hexadecimal. Escolha um que não apareça nos dados.Any single character_ (underscore)

Como funciona

^FH avisa a impressora de que o próximo ^FD contém escapes hexadecimais: um sublinhado seguido de dois dígitos hexadecimais representa um byte. _5E é o acento circunflexo, _7E é o til, _5F é o próprio sublinhado.

Isso existe porque ^ e ~ iniciam comandos. Escritos direto no ^FD eles encerram o campo, e o resto dos seus dados é executado como ZPL. O ^FH é a saída, e é o que você precisa para preços com circunflexo, caminhos com til ou qualquer dado vindo de um banco que você não controla.

O parâmetro opcional troca o caractere de escape, útil quando o sublinhado é comum nos seus dados. O ^FH vale apenas para o ^FD seguinte e é limpo pelo ^FS, então precisa ser repetido em cada campo que precisar dele.

Exemplo

ZPL
^XA
^FO40,60^A0N,40,40^FH^FD100_25 _5E _7E^FS
^XZ

Renderizando…

_25, _5E e _7E imprimem %, ^ e ~ — caracteres que o ^FD não consegue carregar direto.
Abrir no visualizador

O que o preview deste site faz com ele

Suportado integralmente, inclusive com indicador personalizado. Escapes de UTF-8 multibyte são expandidos byte a byte, que é o comportamento de uma impressora que não selecionou UTF-8 com ^CI28.

Erros comuns

  • Colocar o ^FH depois do ^FD. Ele tem que vir antes, senão os escapes são impressos literalmente.
  • Esperar que o ^FH valha para o campo seguinte. Ele é limpo pelo ^FS.
  • Usar um número ímpar de dígitos hexadecimais. _5 não é um escape e sai como está escrito.

Veja também