Plataforma de Comunicação Elgin versão 3.13.9
Documentação das bibliotecas de integração com hardware Elgin
Funções
Formatação de Label
Impressoras » Etiqueta

Comandos de Formatação de Label (Label Formatting Commands) fornecem funções para configurar as propriedades de formatação da etiqueta, tais como margens (offsets), calor e velocidade de impressão. Mais...

Funções

int SetOffsetLinha (int offsetLinha)
 Define a margem inferior da impressão (a distância, a partir da margem inferior da etiqueta, em que o eixo y de impressão será posicionado). Mais...
 
int SetOffsetColuna (int offsetColuna)
 Define a margem esquerda da impressão (a distância, a partir da margem esquerda da etiqueta, em que o eixo x de impressão será posicionado). Mais...
 
int SetVelImpressao (int velImpressao)
 Define a velocidade de impressão. Mais...
 
int SetTamPixel (int largura, int altura)
 Define a largura e a altura do pixel que será usado na etiqueta. Mais...
 
int SetCalor (int calor)
 Define o calor de impressão, isto é, o quão forte será a cor da impressão. Mais...
 
int SetQtde (int qtde)
 Define quantas vezes a etiqueta será impressa. Mais...
 
int SetCortarZero (int cortarZero)
 Define se o número zero (0) deve ser "cortado" ou não, para distingui-lo da letra O. Mais...
 
int SetLogicImgMode (int logicImgMode)
 Define o modo lógico de impressão dos campos. Mais...
 
int SetMirror (int mirror)
 Define se os textos serão espelhados ou não durante a impressão. Mais...
 

Descrição detalhada

Comandos de Formatação de Label (Label Formatting Commands) fornecem funções para configurar as propriedades de formatação da etiqueta, tais como margens (offsets), calor e velocidade de impressão.

Convenções usadas nas chamadas das funções da biblioteca:
Windows

‍__stdcall

Linux

‍__cdecl

Funções

◆ SetOffsetLinha()

int SetOffsetLinha ( int  offsetLinha)

Define a margem inferior da impressão (a distância, a partir da margem inferior da etiqueta, em que o eixo y de impressão será posicionado).

Parâmetros
offsetLinha- Parâmetro do tipo numérico que define a posição do eixo y no plano da etiqueta, de baixo para cima.

Valores válidos:

‍Números entre 0 e 9999 (0, 1, 2, ..., 9999).


Exemplos:
Valor Offset de Linha (métrico) Offset de Linha (imperial)
5 Meio milímetro 5 centésimos de polegada
10 1 milímetro 1 décimo de polegada
200 2 centímetros 2 polegadas
4500 45 centímetros 45 polegadas

  • Se esta função não for usada, assume-se o valor 0.
  • OBS: Atente-se ao valor configurado na função SetMedidas.

Retorna
O retorno da função é do tipo numérico.
A função bem-sucedida deve retornar 0.

◆ SetOffsetColuna()

int SetOffsetColuna ( int  offsetColuna)

Define a margem esquerda da impressão (a distância, a partir da margem esquerda da etiqueta, em que o eixo x de impressão será posicionado).

Parâmetros
offsetColuna- Parâmetro do tipo numérico que define a posição do eixo x no plano da etiqueta, da esquerda para a direita.

Valores válidos:

‍Números entre 0 e 9999 (0, 1, 2, ..., 9999).


Exemplos:
Valor Offset de Coluna (métrico) Offset de Coluna (imperial)
5 Meio milímetro 5 centésimos de polegada
10 1 milímetro 1 décimo de polegada
200 2 centímetros 2 polegadas
4500 45 centímetros 45 polegadas

  • Se esta função não for usada, assume-se o valor 0.
  • OBS: Atente-se ao valor configurado na função SetMedidas.

Retorna
O retorno da função é do tipo numérico.
A função bem-sucedida deve retornar 0.

◆ SetVelImpressao()

int SetVelImpressao ( int  velImpressao)

Define a velocidade de impressão.

Parâmetros
velImpressao- Parâmetro do tipo numérico que define a velocidade de impressão.

Valores válidos:
Valor Velocidade
0 1,0"/seg
1 1,5"/seg
2 2,0"/seg
3 2,5"/seg
4 3,0"/seg
5 3,5"/seg
6 4,0"/seg
7 4,5"/seg
8 5,0"/seg
9 5,5"/seg
10 6,0"/seg
11 7,0"/seg

  • Se esta função não for usada, assume-se o valor 2.
  • OBS: Certifique-se de que a impressora suporta a velocidade selecionada.

Retorna
O retorno da função é do tipo numérico.
A função bem-sucedida deve retornar 0.

◆ SetTamPixel()

int SetTamPixel ( int  largura,
int  altura 
)

Define a largura e a altura do pixel que será usado na etiqueta.

Parâmetros
largura- Parâmetro do tipo numérico que define a largura do pixel.

Valores válidos:

‍1 ou 2 (1, 2).


  • Se esta função não for usada, assume-se o valor 1.

altura- Parâmetro do tipo numérico que define a altura do pixel.

Valores válidos:

‍Números entre 1 e 3 (1, 2, 3).


  • Se esta função não for usada, assume-se o valor 1.

Retorna
O retorno da função é do tipo numérico.
A função bem-sucedida deve retornar 0.

◆ SetCalor()

int SetCalor ( int  calor)

Define o calor de impressão, isto é, o quão forte será a cor da impressão.

Parâmetros
calor- Parâmetro do tipo numérico que define o calor de impressão.

Valores válidos:

‍Números entre 0 e 20 (0, 1, 2, ..., 20).


  • Se esta função não for usada, assume-se o valor 9.

Retorna
O retorno da função é do tipo numérico.
A função bem-sucedida deve retornar 0.

◆ SetQtde()

int SetQtde ( int  qtde)

Define quantas vezes a etiqueta será impressa.

Parâmetros
qtde- Parâmetro do tipo numérico que define a quantidade de vezes que a etiqueta será impressa.

Valores válidos:

‍Números entre 0 e 9999 (0, 1, 2, ..., 9999).


  • Se esta função não for usada, assume-se o valor 1.

Retorna
O retorno da função é do tipo numérico.
A função bem-sucedida deve retornar 0.

◆ SetCortarZero()

int SetCortarZero ( int  cortarZero)

Define se o número zero (0) deve ser "cortado" ou não, para distingui-lo da letra O.

Parâmetros
cortarZero- Parâmetro do tipo numérico que define se o zero será cortado na impressão.

Valores válidos:
Valor Cortar zero?
0 Não
1 Sim

  • Se esta função não for usada, assume-se o valor 1.
  • OBS: Esta propriedade só afeta as fontes alfanuméricas de 0 a 6 (veja a função GerarTexto).

Retorna
O retorno da função é do tipo numérico.
A função bem-sucedida deve retornar 0.

◆ SetLogicImgMode()

int SetLogicImgMode ( int  logicImgMode)

Define o modo lógico de impressão dos campos.

Parâmetros
logicImgMode- Parâmetro do tipo numérico que define se a impressora irá operar no modo lógico XOR (eXclusive OR) ou no modo lógico OR.

Este parâmetro influencia no resultado da impressão de campos com partes sobrepostas: no modo XOR, essas partes não seriam impressas e, no modo OR, seriam.

Suponha o caso em que um texto estaria dentro de uma linha sólida (e totalmente sobreposto pela linha, portanto): no modo XOR, o texto não seria impresso, permitindo sua visibilidade e, no modo OR, o texto seria impresso junto com a linha, tornando-o indistinguível.

Valores válidos:
Valor Modo lógico
1 XOR
2 OR

  • Se esta função não for usada, assume-se o valor 1.

Retorna
O retorno da função é do tipo numérico.
A função bem-sucedida deve retornar 0.

◆ SetMirror()

int SetMirror ( int  mirror)

Define se os textos serão espelhados ou não durante a impressão.

Parâmetros
mirror- Parâmetro do tipo numérico que define se o texto será espelhado na impressão.

Valores válidos:
Valor Espelhar?
0 Não
1 Sim

  • Se esta função não for usada, assume-se o valor 0.

Retorna
O retorno da função é do tipo numérico.
A função bem-sucedida deve retornar 0.