DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Champs, pages et fenêtres / Fonctions Planning
  • Utilisation du type Rendezvous
  • Propriétés spécifiques à la gestion des champs Agenda et Planning
  • Propriétés spécifiques à la gestion des fonctions RendezVous
  • Fonctions utilisant les variables de type RendezVous
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
Le type RendezVous permet de définir toutes les caractéristiques avancées d'un rendez-vous : horaires, lieu, ...
Ce type de variable peut être utilisé :
  • WINDEVWEBDEV - Code ServeurWEBDEV - Code NavigateurAndroidWidget AndroidiPhone/iPadWidget IOSMac CatalystPHP dans un champ Agenda ou dans un champ Planning. Le type RendezVous sera manipulé avec les fonctions WLangage de gestion des champs Agenda ou des champs Planning.
  • AndroidWidget AndroidiPhone/iPadWidget IOSMac Catalyst par les fonctions de gestion des rendez-vous sur un appareil Android ou iOS.
Les caractéristiques de ce rendez-vous peuvent être définies et modifiées à l'aide de différentes propriétés WLangage.
Remarque : Pour plus de détails sur la déclaration de ce type de variable et l'utilisation des propriétés WLangage, consultez Déclaration d'une variable.
Universal Windows 10 App En mode Universal Windows 10 App, ce type de variable permet uniquement de manipuler les rendez-vous des champs Planning présents dans un état.
Exemple
// Construction d'une variable de type RendezVous
MonRendezVous est un RendezVous

// Le rendez-vous commence immédiatement et dure deux heures
MonRendezVous.DateDébut = DateSys() + HeureSys()
MonRendezVous.DateFin = MonRendezVous.DateDébut
MonRendezVous.DateFin.Heure = MonRendezVous.DateFin.Heure + 2

MonRendezVous.Titre = "Rendez-vous avec le directeur commercial"
MonRendezVous.Importance = 1
MonRendezVous.Invité = "Michel, Antoine, Sandra"
MonRendezVous.Contenu = "Mise au point de la nouvelle grille de tarifs"
MonRendezVous.Note = "Penser Ã  prendre le dossier bleu."
MonRendezVous.Bulle = MonRendezVous.Titre + RC + MonRendezVous.Note

// Ajout du rendez-vous dans l'agenda
AgendaAjouteRendezVous(AGD_MonAgenda, MonRendezVous)
// Ajoute un rendez-vous en utilisant le type RendezVous et avec répétition
// Tous les premier lundi du mois 
// un Lundi dans les jours de 1 Ã  7 du mois = le 1er du mois.

x est un RendezVous
x.DateDébut = DateDuJour() + "1200"
x.DateFin = DateDuJour() + "1400"
x.AvecRépétition = Vrai
y est une Répétition
y.Type = plnTousLesJours
y.JourDeLaSemaine = 1 
y.JourDuMois = "1-7" 
y.JourDuMoisOuDeLaSemaine = Faux
x.Répétition = y
AgendaAjouteRendezVous(AGD_Agenda, x)
AndroidWidget AndroidiPhone/iPadWidget IOSMac Catalyst
gRDV est un RendezVous
gCal est un Calendrier
tabCalendrier est un tableau de Calendrier 
// Récupère la liste des calendriers
tabCalendrier = RendezVousListeCalendrier()
gCal = tabCalendrier[1]

// Ajout d'un nouveau rendez-vous dans le premier calendrier
gRDV.Titre = SAI_Titre
gRDV.DateDébut = SAI_DateDeb + SAI_HeureDeb
gRDV.DateFin = SAI_DateFin + SAI_HeureFin
gRDV.Lieu = SAI_Lieu
gRDV.Contenu = SAI_Desc
SI SAI_Fuseau <> "" ALORS
gRDV.FuseauHoraire = SAI_Fuseau
FIN
gRDV.Auteur = SAI_Auteur
gRDV.Invité = SAI_Invités
gRDV.JournéeEntière = INT_Jentière[1]

SI RendezVousAjoute(gCal, gRDV) ALORS
ToastAffiche("RDV ajouté")
SINON
Erreur(ErreurInfo())
FIN
Remarques

Utilisation du type Rendezvous

Le type Rendezvous peut être utilisé pour la gestion des champs Agenda et Planning et pour la gestion des contacts via les fonctions RendezVous.
Cette page d'aide présente :

Propriétés spécifiques à la gestion des champs Agenda et Planning

Les propriétés suivantes peuvent être utilisées pour manipuler un rendez-vous :
Nom de la propriétéType manipuléEffet
AuteurChaîne de caractèresNom de l'auteur du rendez-vous. Si cette propriété n'est pas précisée, le rendez-vous n'a pas d'auteur.
WEBDEV - Code Navigateur Cette propriété n'est pas disponible.
AvecRépétitionBooléen
  • Vrai si le rendez-vous doit être répété,
  • Faux si le rendez-vous n'a lieu qu'une seule fois.
Si le rendez-vous est répété, la propriété Répétition permet de spécifier la fréquence de la répétition.
Par défaut, cette propriété est à Faux.
WEBDEV - Code Navigateur Cette propriété n'est pas disponible.
BulleChaîne de caractèresBulle d'aide affichée lors du survol du rendez-vous. Par défaut, cette valeur est composée de l'heure de début et fin du rendez-vous ainsi que du titre du rendez-vous.
AndroidWidget AndroidiPhone/iPadWidget IOSMac Catalyst Cette propriété n'est pas disponible.
CatégorieChaîne de caractèresCatégorie du rendez-vous. Si cette propriété n'est pas précisée, le rendez-vous n'est associé à aucune catégorie.
ContenuChaîne de caractèresDétail de la description du rendez-vous.
Dans le cas d'un champ Planning (ou Agenda), le contenu est affiché dans le champ.
Si cette propriété n'est pas précisée, le rendez-vous n'a pas de description.
CouleurFondEntierCouleur de fond utilisée pour l'affichage du rendez-vous dans le champ Agenda ou le champ Planning.
Cette couleur peut correspondre à :Si cette propriété n'est pas précisée, une couleur sera automatiquement calculée. Les rendez-vous de la même catégorie auront la même couleur.
DateDébutChaîne de caractères ou variable de type DateHeureDate et heure de début du rendez-vous. Cette propriété doit être affectée avec une date valide avant l'utilisation de la variable.
Cette propriété est obligatoire.
DateFinChaîne de caractères ou variable de type DateHeureDate et heure de fin du rendez-vous. Cette propriété doit être affectée avec une date valide avant l'utilisation de la variable.
Cette propriété est obligatoire.
IDChaîne de caractèresIdentifiant associé au rendez-vous. Permet de stocker l'identifiant d'un élément à associer au rendez-vous pour l'utiliser en programmation plus tard.
Par exemple, cet identifiant peut correspondre à l'identifiant d'un enregistrement dans une base de données.
ImageChaîne de caractèresImage associée au rendez-vous. Cette image est affichée dans le champ Agenda ou le champ Planning (en plus du pictogramme représentant un rendez-vous important si nécessaire).
Cette propriété peut correspondre :
  • au chemin vers une image accessible depuis le poste en cours,
  • à un fichier image présent dans la bibliothèque de l'application,
  • à un champ Image contenant une image,
  • à un dessin réalisé dans un champ Image grâce aux fonctions de dessin et sauvegardé en mémoire.
Si cette propriété n'est pas précisée, le rendez-vous n'a pas d'image associée.
WEBDEV - Code Serveur Le fichier image doit être présent dans le répertoire <Nom_Projet>_WEB. Le chemin indiqué doit être relatif à ce répertoire.
WEBDEV - Code Navigateur Cette propriété n'est pas disponible.
ImportanceEntierImportance du rendez-vous.
Si cette propriété est supérieure ou égale à 1, un pictogramme (Pictogramme de rendez-vous important.) sera affiché dans le champ Agenda ou dans le champ Planning pour indiquer un rendez-vous important.
Si cette propriété n'est pas précisée, sa valeur vaut 0.
WEBDEV - Code Navigateur Cette propriété n'est pas disponible.
JournéeEntièreBooléen
  • Vrai si le rendez-vous est un rendez-vous à la journée entière.
  • Faux dans le cas contraire (valeur par défaut).
WINDEVWEBDEV - Code ServeurWEBDEV - Code NavigateurPHP Attention : Pour que le rendez-vous à la journée entière soit correctement affiché dans le champ, il est nécessaire que l'option "Afficher et autoriser les rendez-vous à la journée entière" soit cochée dans l'onglet "Détail" de la description du champ.
LieuChaîne de caractèresLieu du rendez-vous.
Si cette propriété n'est pas précisée, le rendez-vous n'a pas de lieu fixé.
WEBDEV - Code Navigateur Cette propriété n'est pas disponible.
NoteChaîne de caractèresNote associée au rendez-vous.
Si cette propriété n'est pas précisée, aucune note n'est associée au rendez-vous.
WEBDEV - Code Navigateur Cette propriété n'est pas disponible.
OrdreEntierOrdre des rendez-vous (cas des rendez-vous qui se chevauchent).
WEBDEV - Code ServeurWEBDEV - Code NavigateurPHP Cette propriété n'est pas disponible.
RépétitionVariable de type RépétitionParamètres avancés de la répétition. Cette propriété est prise en compte uniquement si la propriété AvecRépétition est égale à Vrai.
WEBDEV - Code Navigateur Cette propriété n'est pas disponible.
RessourceChaîne de caractèresRessource associée au rendez-vous. Cette propriété est prise en compte uniquement lorsque le rendez-vous est utilisé par un champ Planning.
TitreChaîne de caractèresTitre du rendez-vous. Le titre est affiché dans le champ Agenda ou Planning.
Si cette propriété n'est pas précisée, le rendez-vous n'a aucun titre.
AndroidWidget AndroidiPhone/iPadWidget IOSMac Catalyst

Propriétés spécifiques à la gestion des fonctions RendezVous

Les propriétés suivantes peuvent être utilisées pour manipuler un rendez-vous :
Nom de la propriétéType manipuléEffet
AuteurChaîne de caractèresNom de l'auteur du rendez-vous. Si cette propriété n'est pas précisée, le rendez-vous n'a pas d'auteur.
iPhone/iPadWidget IOSMac Catalyst Cette propriété n'est pas gérée.
CalendrierVariable de type Calendrier
  • Calendrier auquel appartient le rendez-vous.
  • Null si le rendez-vous n'appartient à aucun calendrier.
  • Calendrier auquel appartient le rendez-vous.
  • Null si le rendez-vous n'appartient à aucun calendrier.
Pour ajouter un rendez-vous à un calendrier donné, utilisez la fonction RendezVousAjoute.
ContenuChaîne de caractèresDétail de la description du rendez-vous.
Si cette propriété n'est pas précisée, le rendez-vous n'a pas de description.
DateDébutChaîne de caractères ou variable de type DateHeureDate et heure de début du rendez-vous. Cette propriété doit être affectée avec une date valide avant l'utilisation de la variable.
L'heure de début du rendez-vous est toujours exprimée dans le fuseau horaire associé au rendez-vous. Le nom du fuseau horaire peut être connu avec la propriété FuseauHoraire.
DateFinChaîne de caractères ou variable de type DateHeureDate et heure de fin du rendez-vous. Cette propriété doit être affectée avec une date valide avant l'utilisation de la variable.
L'heure de fin du rendez-vous est toujours exprimée dans le fuseau horaire associé au rendez-vous. Le nom du fuseau horaire peut être connu avec la propriété FuseauHoraire.
FuseauHoraireChaîne de caractèresNom du fuseau horaire des heures de début et de fin du rendez-vous. Ce nom doit correspondre à un nom complet du fuseau définit par l'IANA Time Zone Database. Par exemple : "Europe/Paris", "Europe/London", "America/New_York", ...
Par défaut, cette propriété est initialisée avec le fuseau horaire courant. Pour réinitialiser cette propriété avec le fuseau horaire courant, utilisez "" (chaîne vide).
IDChaîne de caractèresIdentifiant associé au rendez-vous. Permet de stocker l'identifiant d'un élément à associer au rendez-vous pour l'utiliser en programmation plus tard.
Cette propriété est en lecture seule. Cette propriété est renseignée automatiquement lors de la lecture du rendez-vous dans le calendrier correspondant. Il est déconseillé de mémoriser cet identifiant au-delà de la durée de vie de l'application car cet identifiant peut être modifié lors de la synchronisation des calendriers.
InvitéChaîne de caractèresListe des personnes invitées au rendez-vous.
Si cette propriété n'est pas précisée, le rendez-vous n'a pas d'invités.
La valeur de cette propriété est de la forme :
<Nom Invité 1> + TAB + <Email Invité 1> + RC + ...
+ RC + <Nom Invité N> + TAB + <Email Invité N>
iPhone/iPadWidget IOSMac Catalyst Cette propriété est disponible en lecture seulement.
JournéeEntièreBooléen
  • Vrai si le rendez-vous est un rendez-vous à la journée entière.
  • Faux dans le cas contraire (valeur par défaut).
Si cette propriété vaut Vrai :
  • le fuseau horaire associé au rendez-vous doit correspondre à "UTC",
  • les heures de début et de fin de rendez-vous doivent être fixées à minuit.
Exemple : Rendez-vous pour la journée du 17 juillet 2012 :
Rdv est un RendezVous
Rdv.DateDébut = "201201170000"
Rdv.DateFin = "201201180000"
Rdv.JournéeEntière = Vrai
LieuChaîne de caractèresLieu du rendez-vous.
Si cette propriété n'est pas précisée, le rendez-vous n'a pas de lieu fixé.
RappelTableau de variables de type RappelTableau contenant la liste des rappels associés au rendez-vous. Si aucun rappel n'est associé au rendez-vous, le tableau est vide.
TitreChaîne de caractèresTitre du rendez-vous.
Si cette propriété n'est pas précisée, le rendez-vous n'a aucun titre.

Fonctions utilisant les variables de type RendezVous

  • Fonctions de gestion des rendez-vous :
    RendezVousAfficheAffiche un rendez-vous dans l'application native de gestion des rendez-vous de l'appareil mobile (Android ou iOS).
    RendezVousAjouteAjoute un rendez-vous :
    • dans l'agenda d'une messagerie Lotus Notes ou Outlook.
    • dans un calendrier (ou agenda) d'un appareil mobile (Android ou iOS).
    RendezVousCréeAffiche la fenêtre de création de rendez-vous de l'application native de gestion des rendez-vous de l'appareil Android.
    RendezVousModifieModifie le rendez-vous en cours :
    • dans l'agenda d'une messagerie Lotus Notes ou Outlook.
    • dans un calendrier (ou agenda) d'un appareil mobile (Android/iOS).
    RendezVousRAZRéinitialise :
    RendezVousSupprimeSupprime :
    • le rendez-vous en cours de l'agenda d'une messagerie Lotus Notes ou Outlook.
    • un rendez-vous dans un calendrier (ou agenda) d'un appareil mobile (Android/iOS).
Version minimum requise
  • Version 16
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 13/12/2023

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