CBCapture (Fonction)

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

Version :

Accueil | Connexion | Français

Aide / WLangage / Fonctions WLangage / Fonctions standard / Fonctions de gestion de Windows / Fonctions Code-Barres

Conditions d'utilisation
Gestion des erreurs
Application en arrière-plan : Spécificité à partir de Android 10

WINDEV

WEBDEV

WINDEV Mobile

Autres

Voir Aussi

CBCapture (Fonction)

En anglais : BCCapture

Décode les informations stockées dans un code-barres en utilisant la caméra de l'appareil (Android, iPhone, iPad).

Conseil : Préférez le champ Caméra :

Le champ Caméra permet également de décoder directement les codes-barres. Pour plus de détails, consultez Champ Caméra : décoder les codes-barres.
Il est conseillé de remplacer cette fonction par une fenêtre de l'application contenant un champ Caméra qui autorise le décodage des différents codes-barres. Pour plus de détails, consultez Champ Caméra : décoder les codes-barres.

Exemple

// Décodage d'un code-barres QR Code
cb est un CodeBarres
cb = CBCapture()
SI ErreurDétectée = Faux _ET_ cb.TypeContenu = cbTypeEmail ALORS
Info("Adresse email : " + cb.ValeurBrute)
FIN

Syntaxe

<Résultat> = CBCapture([<Type code-barres> [, <Activer le flash>]])

<Résultat> : Variable de type CodeBarres

Variable de type CodeBarres initialisée avec les informations lues dans le code-barres.
Remarque : La propriété TypeCodeBarres de la variable de type CodeBarres n'est pas mise à jour : elle correspond toujours à "QRCode".

<Type code-barres> : Constante de type Entier optionnelle

Type de code-barres pouvant être décodé :
CB_AZTEC Code-barres de type Aztec.
Ce type de code-barres est disponible à partir de iOS 7.
CB_CODE128 Code-barres de type Code128.
Ce type de code-barres est disponible à partir de iOS 7.
CB_CODE39 Code-barres de type Code39.
Ce type de code-barres est disponible à partir de iOS 7.
CB_CODE93 Code-barres de type Code93.
Ce type de code-barres est disponible à partir de iOS 7.
CB_DATAMATRIX Code-barres de type DATAMATRIX.
Non disponible.
CB_EAN128 Code-barres de type EAN128.
Ce type de code-barres est disponible à partir de iOS 7.
CB_EAN13 Code-barres de type EAN13.
Ce type de code-barres est disponible à partir de iOS 7.
CB_EAN8 Code-barres de type EAN8.
Ce type de code-barres est disponible à partir de iOS 7.
CB_INTER2OF5 Code-barres de type Interleaved 2 of 5.
Ce type de code-barres est disponible à partir de iOS 7.
CB_PDF417 Code-barres de type PDF417.
Ce type de code-barres est disponible à partir de iOS 7.
CB_QRCODE Code-barres de type QR Code.
CB_UPCA Code-barres de type UPC-A.
Non disponible.
CB_UPCE Code-barres de type UPC-E.
Ce type de code-barres est disponible à partir de iOS 7.
CB_TOUS Tous les types de codes-barres supportés par cette fonction pourront être décodés.

Si ce paramètre n'est pas spécifié, tous les types de codes-barres supportés par cette fonction pourront être décodés.
A partir d'IOS 7, les codes-barres suivants peuvent être décodés : QR Code, UPCE, Code39, Code39Mod43, EAN13, EAN8, Code93, Code128, PDF417 et Aztec.

<Activer le flash> : Booléen optionnel

Mode de gestion du flash :
Vrai pour activer le flash,
Faux (valeur par défaut) pour ne pas activer le flash.

Remarques

Conditions d'utilisation

Dans une application Android :

La fonction CBCapture ouvre une nouvelle fenêtre affichant la prévisualisation de la caméra de l'appareil. Il suffit ensuite de :
- cadrer le code-barres à décoder dans la zone prévue à cet effet.
- valider comme pour une prise de photo classique.
Le décodage de codes-barres utilise la librairie Zxing (http://code.google.com/p/zxing). Si cette librairie n'est pas présente sur l'appareil, son téléchargement sera automatiquement proposé.
Attention : Cette librairie impose d'utiliser le mode paysage de l'appareil.

Pour les applications iPhone/iPad :

La fonction CBCapture ouvre une nouvelle fenêtre affichant la prévisualisation de la caméra de l'appareil. Il suffit ensuite de cadrer le code-barres à décoder dans la zone prévue à cet effet.
La fenêtre permettant de prendre les photos est inclue dans l'application WINDEV Mobile. Aucune librairie supplémentaire n'est nécessaire.
Version antérieure à iOS 7 : Seuls les codes-barres de type QR Code peuvent être décodés. Si un autre type de code-barres est scanné, le décodage n'est pas effectué. Le bouton "Annuler" de la fenêtre de décodage permet de fermer cette fenêtre. Dans ce cas, la variable de type CodeBarres n'est pas initialisée.

Gestion des erreurs

Pour savoir si la récupération du code-barres a échoué, utilisez la variable ErreurDétectée.

La fonction échouera dans les cas suivants :

si elle est utilisée dans le simulateur,
si elle est utilisée dans l'émulateur,
si elle est utilisée sur un appareil ne disposant pas d'une caméra.
si le bouton "Annuler" a été utilisé. Dans ce cas, la propriété TypeCodeBarre de la variable CodeBarres sera différente de CB_QRCODE.

Si le code-barres est décodé mais que son type n'est pas reconnu, la propriété TypeCodeBarre de la variable CodeBarres correspondra à la constante CB_INCONNU.

Application en arrière-plan : Spécificité à partir de Android 10

A partir de Android 10, il n'est plus possible d'ouvrir une fenêtre lorsque l'application est en arrière-plan.

La fonction CBCapture peut provoquer l'ouverture d'une fenêtre. Si cette fonction est utilisée alors que l'application est en arrière-plan, une erreur fatale sera générée.

Conseils :

Il est possible de savoir si l'application est en arrière-plan grâce à la fonction EnModeArrièrePlan.
Si une application a besoin d'interagir avec l'utilisateur alors qu'elle se trouve en arrière-plan, la solution consiste à afficher une notification (via le type Notification). Lors du clic sur la notification, l'application sera remise au premier plan si la propriété ActiveApplication est à Vrai. Il est également possible d'ouvrir une fenêtre depuis la procédure passée à la propriété ActionClic.

Pour plus de détails, consultez Android 10 : Comportement des applications en arrière-plan.

Liste des exemples associés :

Exemples multiplateforme (WINDEV Mobile) : WM Stocks

[ + ] Cette application permet de réaliser des inventaires et d'enregistrer les résultats dans une base de données.
L'exemple permet de créer des entrées/sorties dans le stock, en scannant directement le code-barres des produits.
Il est optimisé pour être exécuté sur les tablettes.

Android (WINDEV Mobile) : Android Inventaire

[ + ] Cette application permet de réaliser les inventaires et d'enregistrer les résultats dans une base de données.

Classification Métier / UI : Code neutre

Composante : wd280android.aar

Voir Aussi

Version minimum requise

Version 16

Commentaires

Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 12/09/2022

Signaler une erreur ou faire une suggestion | Aide en ligne locale