# Conetar um leitor de código de barras USB

Você pode conectar um leitor de código de barras USB a uma unidade do display e inserir dados em variáveis ou objetos.

Esta seção descreve o procedimento de configuração e como usar um leitor de código de barras USB.

Hide Show

1. Leitor de código de barras USB disponível
2. Destino de entrada de dados
3. Quando o destino da entrada de dados é objeto
4. Quando o destino de entrada de dados é variável
5. Caracteres suportados
6. Notas sobre o uso do leitor de código de barras USB

## Leitor de código de barras USB disponível

Você pode usar um leitor de código de barras USB de classe HID.

Apenas um leitor de código de barras USB pode ser conectado a qualquer momento.

Os layouts de teclado suportados são teclado inglês 101 e teclado japonês 106.

## Destino de entrada de dados

Você pode definir os seguintes destinos para os dados inseridos a partir de um leitor de código de barras USB.

Selecione o destino com a propriedade [Salvar dados em] do leitor de código de barras USB.

Destino | Comentários
Objeto | Você pode usar o leitor de código de barras USB para inserir dados nos seguintes objetos: Objeto que pode exibir um teclado Peças de navegadores da Web
Variável | Você pode inserir dados em uma variável interna STRING.

## Quando o destino da entrada de dados é objeto

### Configurações

1. Na janela do Explorador de projeto, ir para [Arquitetura do sistema] e clique em [Acessórios].
2. Na barra de ferramentas, clique em [Leitor de código de barras USB].
3. Na janela Propriedade, a partir da propriedade [Salvar dados em] selecione [Objetos].
4. Na propriedade [Código de chave] selecione o layout do teclado.

Observação: Você pode suprimir a exibição de um teclado durante a entrada, desativando a propriedade [Usar teclado] do objeto. Ao fazer referência a uma propriedade na propriedade [Usar teclado], você pode projetar uma função que mostra ou oculta o teclado no meio de uma operação.

### Entrada de dados com leitor de código de barras USB

1. Antes de ler os dados com um leitor de código de barras USB, toque o objeto para alterar o seu estado de entrada de modo que ele possa atuar como o destino dos dados de entrada.
   Se os dados forem lidos antes que o estado de entrada seja definido, os dados não serão inseridos em nenhum lugar.
2. Leia os dados com o leitor de código de barras USB.
   Os dados lidos não são completos até que um caractere de controle ('CR' ou 'CR'+'LF') seja lido. Os dados lidos são imediatamente inseridos no objeto.

   Observação:

   - Se houver um caractere que não possa ser inserido, a inserção desse caractere é ignorada.

   - Se forem lidos mais dados do que a faixa de entrada do objeto, nenhum dado é inserido. Neste caso, o bip toca e a cor do objeto é alterada.

   - Se você inserir quaisquer caracteres no teclado e depois ler os dados com o leitor de código de barras USB, os dados lidos serão inseridos seguindo os caracteres exibidos no teclado.

3. Quando a entrada de dados for concluída, o estado de entrada do objeto é encerrado. Quando o teclado for exibido e a entrada de dados for concluída, o teclado fechará automaticamente.

## Quando o destino de entrada de dados é variável

### Configurações

1. Na janela do Explorador de projeto, ir para [Arquitetura do sistema] e clique em [Acessórios].
2. Na barra de ferramentas, clique em [Leitor de código de barras USB].
3. Na janela Propriedade, a partir da propriedade [Salvar dados em] selecione [Variável].
4. Na propriedade [String digitalizada], defina uma variável interna STRING para atuar como o destino dos dados de entrada.

   Observação: Você não pode definir uma variável externa na propriedade [String digitalizada].

5. Se você quiser contar quantos caracteres estão nos dados lidos, defina uma variável inteira interna na propriedade [String digitalizada (bytes)].

   Observação: Você não pode definir uma variável externa na propriedade [String digitalizada (bytes)].

6. Na propriedade [Código de chave] selecione o layout do teclado.

### Entrada de dados com leitor de código de barras USB

1. Leia os dados com um leitor de código de barras USB.
   Os dados lidos não são completos até que um caractere de controle ('CR' ou 'CR'+'LF') seja lido.
2. Os dados lidos são inseridos na variável STRING definida na propriedade [String digitalizada]. Além disso, o número de caracteres nos dados lidos é armazenado na variável inteira definida na propriedade [String digitalizada (bytes)].
3. Quando a entrada de dados estiver concluída, o valor da seguinte propriedade de origem do terminal for definido como LIGADO.
   (Nome do terminal).Preferences.InputCompletedFromUSBBarcodeReader
   Depois que o valor da propriedade de origem for definido como LIGADO, volte-o manualmente para DESLIGADO para que você possa confirmar a conclusão da próxima entrada. O valor nesta propriedade NÃO DESLIGA automaticamente.

Observação: Se o número de caracteres nos dados lidos exceder o número de bytes que podem ser inseridos na variável STRING [String digitalizada], os caracteres em excesso são descartados.

Ler dados | Número de bytes que podem ser inseridos na variável STRING | Valor da variável inteira [String digitalizada (bytes)] *1 | Caracteres inseridos na variável STRING | Comentários
ABC | 5 | 3 | ABC |
ABCDEFG | 5 | 7 | ABCDE | Os caracteres que excedem a faixa de entrada não são inseridos.
AB(0x00)CDEF | 6 | 6 | ABCDEF | 'NULO (0x00)' é ignorado. 'NULO (0x00)' não é suportado.

*1 Ao configurar o leitor de código de barras, use uma variável para especificar o número de bytes para leitura.

## Caracteres suportados

Os seguintes caracteres são suportados ao ler dados com um leitor de código de barras USB.

Se houver caracteres não suportados nos dados lidos, esses caracteres são ignorados e não lidos.

- Caracteres alfanuméricos

- A-Z
- a-z
- 0-9

- Espaço (Em branco)
- Caracteres especiais

  Caracteres especiais
  ! | ) | ; | ]
  " | * | < | ^
  # | + | = | _
  $ | , | > | ` (acento grave)
  % | - | ? | {
  & | . | @ | |
  ' (apóstrofe) | / | [ | }
  ( | : | \ | ~

- Caracteres de controle

- 'CR'

  Observação: O caractere de controle 'CR' indica a entrada completa dos dados.

## Notas sobre o uso do leitor de código de barras USB

### Ao usar a Série SP5000 Open Box (Windows 10 IoT Enterprise Model), Série IPC, ou PC/AT

- Quando o destino de entrada de dados é definido para uma variável, desative o IME com o teclado do sistema antes de ler os dados com um leitor de código de barras USB. A entrada de dados não pode ser concluída com IME habilitado.
- Não use um leitor de código de barras USB para ler caracteres de controle TAB quando o destino de entrada de dados for definido como objeto. Se você ler o caractere de controle do TAB, não será possível completar a entrada de dados. Se você ler acidentalmente o caracteres de controle do TAB, toque manualmente o objeto. Ele retornará ao mesmo estado de antes de qualquer dado ser inserido.
- Mesmo se um leitor de código de barras USB não estiver configurado, se um objeto estiver configurado para seu estado de entrada e os dados forem lidos usando um leitor de código de barras USB, os dados lidos serão inseridos no objeto.