DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Communication / Fonctions Contact (Lotus Notes ou Android/iPhone/iPad)
  • Présentation
  • Gestion des contacts avec utilisation des variables de type Contact
  • Gestion des contacts avec utilisation de la structure Contact (conservée par compatibilité)
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac CatalystUniversal Windows 10 App
Autres
Procédures stockées
Présentation
Dans vos applications mobiles, vous pouvez directement gérer les contacts de votre appareil mobile (Android, iPhone, iPad, Universal Windows).
Pour cela, le WLangage met à votre disposition :
  • les fonctions Contact.
  • des variables avancées du WLangage : Contact, ...
Remarque : Par compatibilité, il est également possible d'utiliser la structure mContact du WLangage. Cette solution n'est pas conseillée et doit être utilisée uniquement pour les applications devant fonctionner avec une version inférieure à Android 2.0.
Gestion des contacts avec utilisation des variables de type Contact
Pour gérer les contacts de l'appareil mobile :
  1. Déclarez une variable de type Contact. Ce type de variable permet de décrire et de connaître toutes les caractéristiques du contact présent dans l'appareil mobile.
  2. Utilisez les fonctions du WLangage selon l'action voulue :
    • Pour lire et afficher dans votre application les contacts présents dans l'appareil mobile, utilisez la fonction ContactListe. Cette fonction remplie un tableau de variables Contact. Vous pouvez ainsi par exemple parcourir le tableau de variables pour ajouter les différents contacts dans une zone répétée. Par exemple :
      gContactEnCours est un Contact
      gtabContacts est un tableau de Contacts
       
      ZoneRépétéeSupprimeTout(ZR_CONTACTS)
       
      // Listing des contacts
      gtabContacts = ContactListe()
       
      SI gtabContacts.Occurrence > 0 ALORS
      // Trie des contacts
      TableauTrie(gtabContacts, ttMembre, "+Nom")
       
      // Ajout dans la zone répétée
      POUR TOUT tContact DE gtabContacts
      ZoneRépétéeAjouteLigne(ZR_CONTACTS, ...
      tContact.Nom, tContact.Prénom)
      FIN
      // Affichage du nombre de contacts
      LIB_NBContacts = ChaîneConstruit("%1 contacts", gtabContacts.Occurrence)
      FIN
    • Pour manipuler directement les contacts avec l'application native du téléphone, utilisez les fonctions suivantes :
      ContactAfficheOuvre la fiche d'un contact dans l'application native de gestion des contacts de l'appareil (Android, iPhone ou iPad, Universal Windows).
      ContactCréeAffiche la fenêtre de création de contact de l'application native de gestion des contacts de l'appareil (Android, iPhone ou iPad, Universal Windows).
      ContactEditeOuvre en édition la fiche d'un contact en cours dans l'application native de gestion des contacts de l'appareil (Android, iPhone ou iPad, Universal Windows).
      ContactSélectionneAffiche la liste des contacts de l'appareil (Android, iPhone ou iPad, Universal Windows).
    • Diverses fonctions WLangage permettent de réaliser toutes les manipulations possibles :
      ContactAjouteAjoute un contact :
      • dans le carnet d'adresses d'une messagerie Lotus Notes ou Outlook.
      • dans la liste des contacts de l'appareil (Android, iPhone ou iPad, Universal Windows).
      ContactListeSourceListe les sources (ou comptes) de contacts enregistrés sur l'appareil.
      ContactModifieModifie le contact en cours dans le carnet d'adresses d'une messagerie Lotus Notes ou Outlook.
      ContactRAZRéinitialise :
      ContactSupprimeSupprime le contact en cours :
      • du carnet d'adresses d'une messagerie Lotus Notes ou Outlook.
      • dans la liste des contacts du téléphone (Android, iPhone ou iPad, Universal Windows).
Liste des exemples associés :
WM Gestion Contacts Exemples multiplateforme (WINDEV Mobile) : WM Gestion Contacts
[ + ] Cet exemple illustre la gestion de contacts pour Android et iOS.
Il permet de :
- lister les contacts du téléphone
- appeler les contacts
- envoyer des sms aux contacts
- ...
Gestion des contacts avec utilisation de la structure Contact (conservée par compatibilité)
Avertissement
A partir de la version 17 (69), cette méthode est indiquée par compatibilité. Cette méthode n'est pas conseillée et doit être conservée uniquement pour les applications utilisant une version antérieure à Android 2.0.
Pour gérer les contacts de l'appareil mobile, il est possible d'utiliser la structure mContact. Cette structure est une structure prédéfinie du WLangage permettant de manipuler un contact.
Pour manipuler les contacts de l'appareil mobile :
  • Parcourez les différents contacts avec les fonctions suivantes :
    ContactDernierLit le dernier contact présent dans le carnet d'adresses d'une messagerie Lotus Notes ou Outlook.
    ContactLitLit un contact présent dans le carnet d'adresses d'une messagerie Lotus Notes ou Outlook.
    ContactPrécédentLit le contact précédent du contact en cours dans le carnet d'adresses d'une messagerie Lotus Notes ou Outlook.
    ContactPremierLit le premier contact présent dans le carnet d'adresses d'une messagerie Lotus Notes ou Outlook.
    ContactSuivantLit le contact suivant du contact en cours dans le carnet d'adresses d'une messagerie Lotus Notes ou Outlook.

    La variable mContact.EnDehors permet de savoir si un enregistrement est en cours.
  • Manipulez le contact en cours avec les fonctions suivantes :
    ContactAfficheOuvre la fiche d'un contact dans l'application native de gestion des contacts de l'appareil (Android, iPhone ou iPad, Universal Windows).
    ContactAjouteAjoute un contact :
    • dans le carnet d'adresses d'une messagerie Lotus Notes ou Outlook.
    • dans la liste des contacts de l'appareil (Android, iPhone ou iPad, Universal Windows).
    ContactChercheRecherche un contact dans le carnet d'adresses d'une messagerie Lotus Notes ou Outlook.
    ContactEditeOuvre en édition la fiche d'un contact en cours dans l'application native de gestion des contacts de l'appareil (Android, iPhone ou iPad, Universal Windows).
    ContactLitLit un contact présent dans le carnet d'adresses d'une messagerie Lotus Notes ou Outlook.
    ContactModifieModifie le contact en cours dans le carnet d'adresses d'une messagerie Lotus Notes ou Outlook.
    ContactRAZRéinitialise :
    ContactSélectionneAffiche la liste des contacts de l'appareil (Android, iPhone ou iPad, Universal Windows).
    ContactSupprimeSupprime le contact en cours :
    • du carnet d'adresses d'une messagerie Lotus Notes ou Outlook.
    • dans la liste des contacts du téléphone (Android, iPhone ou iPad, Universal Windows).
Version minimum requise
  • Version 16
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 25/05/2022

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