ContactAjoute (Fonction)

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

Version :

Accueil | Connexion | Français

Aide / WLangage / Fonctions WLangage / Communication / Fonctions Contact (Lotus Notes ou Android/iPhone/iPad)

Cas particulier
Permissions requises
Fonctionnalité d'application requise

WINDEV

WEBDEV

WINDEV Mobile

Autres

Voir Aussi

ContactAjoute (Fonction)

En anglais : ContactAdd

Ajoute un contact :

dans le carnet d'adresses d'une messagerie Lotus Notes ou Outlook.
Attention : Cette fonction ne permet pas d'ajouter un contact dans le carnet d'adresses d'une messagerie Outlook Express.
dans la liste des contacts de l'appareil (Android, iPhone, iPad, Universal Windows).

Exemple

Voir des exemples supplémentaires

// Initialisation des variables de la structure Contact
ContactRAZ()
// Renseignements des variables pour le nouveau contact
mContact.Nom = "Dupont"
mContact.Prénom = "Axelle"
mContact.Email = "axelle.dupont@mesmails.com"
// Ajout du contact
SI ContactAjoute(IDSession) = Vrai ALORS
Info("Contact ajouté")
SINON
Erreur("Erreur lors de l'ajout", ErreurInfo())
FIN

// Variables locales
tContact est un Contact
tTéléphone est un Téléphone

// Identité
tContact.Nom = SAI_Nom
tContact.Prénom = SAI_Prénom

// Numéros de téléphone Fixe
SI SAI_TéléphoneFixe <> "" ALORS
tTéléphone.Numéro = SAI_TéléphoneFixe
tTéléphone.Type = telDomicile
Ajoute(tContact.Téléphone, tTéléphone)
FIN

// Ajout
SI PAS ContactAjoute(tContact, gSource) ALORS
Erreur("Impossible de créer le contact.")
SINON
FEN_TableContacts.RafraichitListeContact()
Ferme()
FIN

Syntaxe

Ajouter un contact dans la messagerie Lotus Notes ou Outlook Masquer les détails

<Résultat> = ContactAjoute(<Identifiant de la session>)

<Résultat> : Booléen

Vrai si l'ajout a été effectué,
Faux dans le cas contraire. Pour connaître le libellé de l'erreur, utilisez la fonction ErreurInfo avec la constante errMessage.

<Identifiant de la session> : Entier

Identifiant de la session à utiliser. Cet identifiant est renvoyé par la fonction EmailOuvreSessionNotes, EmailOuvreSessionOutlook, NotesOuvreBase ou OutlookOuvreSession.

Ajouter un contact dans la liste des contacts de l'appareil Masquer les détails

<Résultat> = ContactAjoute(<Contact> [, <Source>])

<Résultat> : Booléen

Vrai si l'ajout a été effectué,
Faux dans le cas contraire. Pour connaître le libellé de l'erreur, utilisez la fonction ErreurInfo avec la constante errMessage.

<Contact> : Variable de type Contact

Nom de la variable de type Contact correspondant au contact à ajouter.

<Source> : Variable optionnelle de type ContactSource

Nom de la variable de type ContactSource correspondant à la source ou au compte dans lequel le contact doit être ajouté. Si ce paramètre n'est pas précisé, le contact ne sera associé à aucun compte.

Remarques

Cas particulier

Pour afficher la fenêtre de création d'un contact de l'application native de gestion des contacts de l'appareil, utilisez la fonction ContactCrée.

Permissions requises

L'utilisation de cette fonction entraîne la modification des permissions requises par l'application.
Permission requise : WRITE_CONTACTS
Cette permission autorise l'application à écrire (sans lire) les données des contacts de l'utilisateur.

Fonctionnalité d'application requise

L'utilisation de cette fonction entraîne la déclaration d'une fonctionnalité d'application dans l'assistant de génération de l'application.

Fonctionnalité requise : Contacts

Cette fonctionnalité permet aux applications d'accéder aux contacts.

Liste des exemples associés :

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

Composante : wd280com.dll

Voir Aussi

Version minimum requise

Version 11

Documentation également disponible pour…

Commentaires

Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 20/07/2022

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