Controlo do leitor de código de barras no Power Apps
Digitaliza códigos de barras, códigos QR e códigos de matriz de dados em dispositivos Android, iOS e Windows.
Description
O controlo abre um scanner nativo em dispositivos Android, iOS e Windows. No iOS e Android, o scanner suporta os seguintes modos de digitalização:
- Digitalização automática – um código de barras é digitalizado automaticamente assim que é detetado.
- Selecionar para digitalizar – o utilizador pode determinar qual dos nós detetados digitalizar. O controlo não suporta a leitura num browser web.
- Digitalizar múltiplos – O utilizador pode digitalizar múltiplos códigos de barras durante a sessão de códigos de barras.
Em dispositivos Windows, o leitor de código de barras irá sempre digitalizar automaticamente.
O controlo do leitor de código de barras suporta níveis de zoom diferentes e a ativação/desativação da lanterna do dispositivo numa experiência de digitalização.
Nota
O controlo do scanner de código de barras é suportado em dispositivos Android, iOS e Windows. Todas as outras plataformas mostrarão um aviso a informar que algumas funcionalidades da aplicação não funcionarão.
Propriedades principais
Códigos de barras – Propriedade de saída que contêm uma tabela dos códigos de barras digitalizados com duas colunas: Valor e Tipo. Value é o valor de texto do código que foi digitalizado, enquanto Tipo é o tipo de código que foi digitalizado.
OnScan – Ações a executar quando um código de barras é digitalizado com sucesso.
OnCancel – Ações a executar quando uma verificação de código de barras é cancelada pelo utilizador.
OnChange – Ações a efetuar quando uma propriedade no controlo Leitor de códigos de barras é alterado, incluindo propriedades de saída.
BarcodeType - o tipo de código de barras a examinar. É possível almejar vários tipos de código de barras concatenando-os. Ex. 'Microsoft.BarcodeReader.BarcodeType'.Code128 & 'Microsoft.BarcodeReader.BarcodeType'.Code39. Predefinição: Automático
Modo de digitalização – Optar entre Automatically scan o primeiro código de barras detetado na vista, permitir que o utilizador Select to scan qual dos códigos de barras digitalizar ou Scan multiple códigos de barras numa única sessão. No Windows, a definição do leitor de código de barras será sempre Automatically scan.
Qualidade da digitalização – A qualidade da imagem que o leitor de código de barras digitaliza. Uma qualidade superior é boa para códigos de barras pequenos, mas poderá resultar num desempenho lento. No Windows, a configuração do leitor de código de barras irá sempre digitalizar na qualidade da câmara do dispositivo. Predefinição: Automático.
PreferFrontCamera – Se ativado, o leitor de código de barras assumirá a predefinição para utilizar a câmara frontal, em vez da câmara traseira.
BeepOnScan – Se esta opção estiver ativada, o leitor de código de barras irá reproduzir um bip quando um código de barras é digitalizado.
VibrateOnScan – Se esta opção estiver ativada, o leitor de código de barras irá vibrar quando um código de barras é digitalizado.
Propriedades adicionais
Text - texto apresentado no botão que ativa o scanner.
BorderColor – a cor do limite de um controlo.
BorderStyle – se o limite do controlo é Sólido, Tracejado, Com pontos ou Nenhum.
BorderThickness – a espessura do limite de um controlo.
DisplayMode – se o controlo permite a intervenção do utilizador (Editar), apenas apresenta os dados (Visualizar), ou está desativado (Desativado).
Height – a altura do botão que ativa o scanner.
Tooltip – o texto explicativo que aparece quando o rato passa por cima de um controlo.
Visible – se um controlo é apresentado ou está oculto.
Width – a largura do botão que ativa o scanner.
X – a distância entre o limite esquerdo de um controlo e o limite esquerdo do respetivo recipiente principal (do ecrã, se não existir um recipiente principal).
Y – a distância entre o limite superior de um controlo e o limite superior do recipiente principal (do ecrã, se não existir um recipiente principal).
Diretrizes de acessibilidade
Aplicam-se as mesmas diretrizes para o controlo Botão que se aplicam ao controlo Scanner do código de barras porque é um botão que inicia a digitalização.
Alternativas visuais
O scanner de código de barras é um botão que não apresenta o resultado da verificação. Considere a possibilidade de mostrar o resultado da verificação com um controlo Etiqueta. Defina a propriedade Text como
First(BarcodeReader.Barcodes).Value, em queBarcodeReaderé o nome do controlo Leitor de códigos de barras. Defina a Propriedade Live da etiqueta como Educado para que os utilizadores dos leitores de ecrã sejam notificados sobre alterações. Esta alteração torna o valor lido acessível a todos, independentemente da capacidade visual.Os utilizadores com deficiências visuais e motoras poderão preferir não apontar a câmara a um código de barras. Considere adicionar outro tipo de entrada, tal como um controlo de Introdução de texto, para os utilizadores introduzirem códigos de barras.
Disponibilidade do código de barras por dispositivo
| Tipo de Código de Barras | Suportado no iOS e Android | Suportado no Windows | Notas |
|---|---|---|---|
| QR_CODE | ✔ | ✔ | |
| DATA_MATRIX | ✔ | ✖ | |
| AZTEC | ✔ | ✖ | |
| CODABAR | ✔ | ✔ | |
| CODE_128 | ✔ | ✔ | |
| CODE_39 | ✔ | ✔ | |
| CODE_93 | ✔ | ✖ | |
| EAN | ✔ | ✔ | Suporta EAN_8 e EAN_13 |
| Intercalado 2 de 5 ITF |
✔ | ✖ | |
| PDF_417 | ✔ | ✖ | |
| RSS14 Barra de dados 14 |
✔ | ✖ | Android e iOS suportam Empilhado e Omnidirecional |
| RSS_EXPANDED Barra de dados Expandida |
✔ | ✖ | Android e iOS suportam Empilhado e Omnidirecional |
| UPC | ✔ | ✔ | Suporta UPC_A e UPC_E |
| Micro Código QR | ✔ | ✖ | |
| GS1-DWCode | ✖ | ✖ | |
| MSI | ✖ | ✖ |
Controlo Select() Leitor de códigos de barras
O controlo Leitor de códigos de barras não suporta Select(). Como alternativa, defina a cor de preenchimento do leitor de código de barras como transparente e coloque-o em frente do controlo com que pretende selecionar o leitor de código de barras. Isto resultará na mesma experiência para o utilizador da aplicação, onde a seleção do controlo inicia a experiência do leitor de código de barras, uma vez que ele selecionará um botão invisível de leitor de código de barras, em vez de um controlo real.
Consulte também
Limitações de controlos no Power Apps
Nota
Pode indicar-nos as suas preferências no que se refere ao idioma da documentação? Responda a um breve inquérito. (tenha em atenção que o inquérito está em inglês)
O inquérito irá demorar cerca de sete minutos. Não são recolhidos dados pessoais (declaração de privacidade).