PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

  • Radio visible et demande de connexion
  • Permissions requises
  • Limitation
  • Application en arrière-plan : Spécificité Android 10
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget iOSApple WatchCatalystUniversal Windows 10 AppWindows Mobile
Autres
Procédures stockées
BTChangeVisibilité (Fonction)
En anglais : BTChangeVisibility
Change la visibilité d'une radio Bluetooth.
Remarque : Une radio Bluetooth correspond à un émetteur Bluetooth. Cet émetteur peut par exemple correspondre à une clé USB Bluetooth, ou être un élément intégré au poste (par exemple dans le cas d'un portable).
Versions 16 et supérieures
Android Cette fonction est désormais disponible pour les applications Android.
Android Attention : Les fonctions Bluetooth ne sont pas disponibles dans l'émulateur Android.
Nouveauté 16
Android Cette fonction est désormais disponible pour les applications Android.
Android Attention : Les fonctions Bluetooth ne sont pas disponibles dans l'émulateur Android.
Android Cette fonction est désormais disponible pour les applications Android.
Android Attention : Les fonctions Bluetooth ne sont pas disponibles dans l'émulateur Android.
Exemple
bVisible est un booléen
// Identifiant des radios Bluetooth listés dans un champ Table
nIdRadio est un entier
nIdRadio = TABLE_Radios.COL_ID[TABLE_Radios]
// Teste si la radio sélectionnée est visible
bVisible = BTEstVisible(nIdRadio)
// Affichage
SI bVisible = Vrai ALORS
Trace("Visible")
SINON
Trace("Non visible")
FIN
// Changement de la visibilité
BTChangeVisibilité(nIdRadio, PAS bVisible)
Syntaxe
Etats et RequêtesWindowsAjaxCode Utilisateur (MCU)

Syntaxe utilisable sous Windows Masquer les détails

<Résultat> = BTChangeVisibilité(<Identifiant de la radio> , <Nouvel état>)
<Résultat> : Booléen
  • Vrai si le changement de visibilité a réussi,
  • Faux dans le cas contraire. La fonction ErreurInfo permet d'obtenir plus de renseignements sur le problème rencontré.
<Identifiant de la radio> : Entier
Identifiant de la radio Bluetooth à manipuler. Cet identifiant est retourné par la fonction BTListeRadio.
<Nouvel état> : Booléen
  • Vrai pour que la radio devienne visible,
  • Faux pour que la radio soit cachée.
AndroidWindows Mobile

Syntaxe utilisable sur Mobile et Android Masquer les détails

<Résultat> = BTChangeVisibilité(<Nouvel état> [, <Durée>])
<Résultat> : Booléen
  • Vrai si le changement de visibilité a réussi,
  • Faux dans le cas contraire. La fonction ErreurInfo permet d'obtenir plus de renseignements sur le problème rencontré.
<Nouvel état> : Booléen
  • Vrai pour que la radio devienne visible,
  • Faux pour que la radio soit cachée.
Versions 16 et supérieures
Android Il n'est pas possible de désactiver la visibilité par programmation. Cette désactivation est uniquement temporaire.
Nouveauté 16
Android Il n'est pas possible de désactiver la visibilité par programmation. Cette désactivation est uniquement temporaire.
Android Il n'est pas possible de désactiver la visibilité par programmation. Cette désactivation est uniquement temporaire.
<Durée> : Entier optionnel ou Durée optionnelle
Durée en secondes durant laquelle le périphérique doit être rendu visible. Ce paramètre doit être compris entre 1 et 300 secondes. Par défaut, la durée de visibilité est de 120 secondes.
Ce paramètre peut correspondre à :
  • un entier correspondant au nombre de secondes,
  • une variable de type Durée,
  • Versions 23 et supérieures
    l'indication directe de la durée (par exemple 1 s).
    Nouveauté 23
    l'indication directe de la durée (par exemple 1 s).
    l'indication directe de la durée (par exemple 1 s).
Windows Mobile Ce paramètre n'est pas pris en compte.
Remarques

Radio visible et demande de connexion

Une radio Bluetooth visible accepte automatiquement les demandes de connexion. Lorsque la fonction BTChangeVisibilité permet de rendre la radio visible, l'appel à la fonction BTChangeConnectivité est automatiquement réalisé.
Versions 16 et supérieures
Android Sous Android, la visibilité de l'appareil vis-à-vis des autres périphériques Bluetooth est toujours temporaire (5 minutes maximum). Si la fonction BTChangeVisibilité est utilisée pour rendre l'appareil visible, une boîte de dialogue système sera affichée pour demander confirmation à l'utilisateur.
Remarque : Cette boîte de dialogue est imposée par le système Android et ne peut donc pas être évitée.
Boite de confirmation Android
Nouveauté 16
Android Sous Android, la visibilité de l'appareil vis-à-vis des autres périphériques Bluetooth est toujours temporaire (5 minutes maximum). Si la fonction BTChangeVisibilité est utilisée pour rendre l'appareil visible, une boîte de dialogue système sera affichée pour demander confirmation à l'utilisateur.
Remarque : Cette boîte de dialogue est imposée par le système Android et ne peut donc pas être évitée.
Boite de confirmation Android
Android Sous Android, la visibilité de l'appareil vis-à-vis des autres périphériques Bluetooth est toujours temporaire (5 minutes maximum). Si la fonction BTChangeVisibilité est utilisée pour rendre l'appareil visible, une boîte de dialogue système sera affichée pour demander confirmation à l'utilisateur.
Remarque : Cette boîte de dialogue est imposée par le système Android et ne peut donc pas être évitée.
Boite de confirmation Android
Versions 16 et supérieures
Android

Permissions requises

L’utilisation de cette fonction entraîne la modification des permissions requises par l’application.
Permission requise : BLUETOOTH.
Cette permission permet aux applications de se connecter à des services Bluetooth.
Nouveauté 16
Android

Permissions requises

L’utilisation de cette fonction entraîne la modification des permissions requises par l’application.
Permission requise : BLUETOOTH.
Cette permission permet aux applications de se connecter à des services Bluetooth.
Android

Permissions requises

L’utilisation de cette fonction entraîne la modification des permissions requises par l’application.
Permission requise : BLUETOOTH.
Cette permission permet aux applications de se connecter à des services Bluetooth.
WindowsWindows Mobile

Limitation

Seule la pile bluetooth Microsoft est supportée par cette fonction. Pour connaître la pile utilisée, utilisez la fonction BTPile.
Pour plus de détails sur les clés supportées, consultez Quelles piles utiliser ?
Versions 25 et supérieures
Android

Application en arrière-plan : Spécificité 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 BTChangeVisibilité 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.
Nouveauté 25
Android

Application en arrière-plan : Spécificité 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 BTChangeVisibilité 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.
Android

Application en arrière-plan : Spécificité 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 BTChangeVisibilité 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.
Composante : wd260com.dll
Version minimum requise
  • Version 12
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire