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.

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 : wd300android.aar

Voir Aussi

Version minimum requise

Version 16

Commentaires

Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 20/03/2024

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