CBCapture (Fonction)

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

Version :

Accueil | Connexion | Français

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).

Remarques :

Versions 21 et supérieures
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.
Nouveauté 21
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.
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 les codes-barres. Pour plus de détails, consultez Champ Caméra : décoder les codes-barres.

Versions 17 et supérieures

Cette fonction est désormais disponible pour les applications iPhone/iPad.

Nouveauté 17

Cette fonction est désormais disponible pour les applications iPhone/iPad.

Versions 18 et supérieures

Cette fonction est désormais disponible en mode Widget Android.

Nouveauté 18

Cette fonction est désormais disponible en mode Widget Android.

Versions 20 et supérieures

De nombreux types de codes-barres sont désormais supportés (à partir de iOS 7).

Nouveauté 20

De nombreux types de codes-barres sont désormais supportés (à partir de iOS 7).

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é :
Versions 21 et supérieures
CB_AZTEC
Nouveauté 21
CB_AZTEC
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.
Versions 22 et supérieures
CB_INTER2OF5
Nouveauté 22
CB_INTER2OF5
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.
Versions 16 et supérieures
CB_QRCODE
Nouveauté 16
CB_QRCODE
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.
Versions 20 et supérieures
CB_TOUS
Nouveauté 20
CB_TOUS
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.
Versions 20 et supérieures
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.
Nouveauté 20
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.
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

Versions 20 et supérieures
Mode de gestion du flash :
Vrai pour activer le flash,
Faux (valeur par défaut) pour ne pas activer le flash.
Nouveauté 20
Mode de gestion du flash :
Vrai pour activer le flash,
Faux (valeur par défaut) pour ne pas activer le flash.
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.

Versions 17 et supérieures

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.

Nouveauté 17

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.

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.
Versions 17 et supérieures
si le bouton "Annuler" a été utilisé. Dans ce cas, la propriété TypeCodeBarre de la variable CodeBarres sera différente de CB_QRCODE.
Nouveauté 17
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 bouton "Annuler" a été utilisé. Dans ce cas, la propriété TypeCodeBarre de la variable CodeBarres sera différente de CB_QRCODE.

Versions 22 et supérieures

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.

Nouveauté 22

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.

Versions 25 et supérieures

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.

Nouveauté 25

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.

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

Voir Aussi

Version minimum requise

Version 16

Commentaires

Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 14/10/2021

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