gglEvénement (Type de variable)

Le type gglEvénement permet de décrire et de modifier un événement d'un agenda. L'agenda est décrit grâce au type gglAgenda. Cet agenda est utilisé par le service Agenda Google Calendar.

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.

Exemple

// Connexion à Google
Cnx est un gglConnexion
Cnx.Email = "balthazar@gmail.com"
Cnx.MotDePasse = "azerty"
Cnx.NomApplication = "MonAppli-01"
SI GglConnecte(Cnx) = Faux ALORS
Erreur(ErreurInfo())
FIN
...
// Récupération du tableau des agendas disponibles
tabAgendas est un tableau de gglAgenda
tabAgendas = GglListeAgenda(Cnx)
// Récupération de tous les événements du premier agenda
GglRemplitAgenda(Cnx, tabAgendas[1])
// Parcours des événements
Evt est un gglEvénement
POUR TOUT Evt DE tabAgendas[1]
Trace(Evt.Titre)
Trace(Evt.Couleur)
Trace(Evt.Notification.Défaut)
Trace(Evt.Notification.Surcharge.Occurrence)
Trace(Evt.Visibilité)
Trace(Evt.Disponibilté)
Trace(Evt.PièceJointe.Occurrence)
POUR TOUT UneNotif DE Evt.Notification.Surcharge
Trace(UneNotif.Méthode)
Trace(UneNotif.NbMinute)
FIN
POUR TOUT UnFichier DE Evt.PièceJointe
Trace(UnFichier.IdFichier)
Trace(UnFichier.Titre)
Trace(UnFichier.URLFichier)
Trace(UnFichier.URLIcone)
Trace(UnFichier.TypeMIME)
FIN
FIN

Remarques

Propriétés spécifiques à la description des variables de type gglEvénement

Les propriétés suivantes peuvent être utilisées pour manipuler un événement d'un agenda grâce au type gglEvénement :

Nom	Type manipulé	Effet

Auteur	gglAuteur	Auteur de l'agenda. Cette propriété est accessible en lecture uniquement.
Contenu	Chaîne de caractères Unicode	Description de l'événement.
Versions 26 et supérieures Couleur Nouveauté 26 Couleur Couleur	Chaîne de caractères Unicode	Identifiant de la couleur de l'événement. Les couleurs disponibles sont les suivantes :
DateDébut	DateHeure	Date de début de l'événement. Remarques : Dans l'interface Google, si l'événement correspond à une journée entière, la date de début de l'événement est celle du jour à 0h00. La date est celle du fuseau horaire de la machine locale.
DateFin	DateHeure	Date de fin de l'événement. Remarques : Dans l'interface Google, si l'événement correspond à une journée entière, la date de fin de l'événement est celle du jour suivant à 0h00. La date est celle du fuseau horaire de la machine locale.
DateMiseAJour	DateHeure	Date de mise à jour de l'événement. Cette propriété est accessible en lecture uniquement. Remarque : La date est celle du fuseau horaire de la machine locale.
Versions 26 et supérieures Disponibilité Nouveauté 26 Disponibilité Disponibilité	Constante de type chaîne	Disponibilité de l'événement. Cette propriété peut correspondre aux constantes suivantes : gglOpaque : Occupé. gglTransparent : Disponible.
Versions 15 et supérieures Identifiant Nouveauté 15 Identifiant Identifiant	Chaîne de caractères Unicode	Identifiant Google de l'événement.
Versions 18 et supérieures JournéeEntière Nouveauté 18 JournéeEntière JournéeEntière		Vrai si l'événement correspond à des journées entières, Faux dans le cas contraire.
Invité[n]	Tableau de gglPersonne	Liste des participants à l'événement. Attention : Lors de la modification d'un événement, les participants ne sont pas prévenus automatiquement des modifications effectuées. Il est nécessaire de programmer cette fonctionnalité si nécessaire.
Lieu		Liste des lieux associés à l'événement.
Versions 26 et supérieures Notification Nouveauté 26 Notification Notification	Variable de type gglNotification	Notifications liées à l'événement.
Versions 26 et supérieures PièceJointe Nouveauté 26 PièceJointe PièceJointe	Variable de type gglPièceJointe	Pièces jointes liées à l'événement.
Titre	Chaîne de caractères Unicode	Titre de l'événement.
Versions 26 et supérieures Visibilité Nouveauté 26 Visibilité Visibilité	Constante de type chaîne	Visibilité de l'événement. Cette propriété peut correspondre aux constantes suivantes : gglConfidentiel : L'événement est confidentiel. gglDéfaut : Visibilité par défaut. gglPublic : L'événement est visible par tous les utilisateurs ayant accès au calendrier. gglPrivé : L'événement est privé.

Versions 20 et supérieures

Gestion des dates et de leur fuseau horaire

Suite à l'utilisation de l'authentification "OAuth 2.0", la gestion des dates a été modifiée. Toutes les dates renvoyées par les fonctions GglRécupèreAgenda, GglListeAgenda, ... dans les variables de type gglEvénement utilisent le fuseau horaire de la machine locale. Elles sont donc utilisables directement dans un champ Calendrier avec le fuseau horaire en cours.

Pour les convertir dans un fuseau horaire particulier, il est possible d'utiliser les fonctions DateHeureLocaleVersFuseau ou DateHeureLocaleVersUTC.

Il est possible de récupérer le fuseau horaire de l'agenda accédé via la propriété FuseauHoraire des variables de type gglAgenda. La valeur renvoyée correspond au nom du fuseau, issu de la base de données "tz" (ou base de données Olson). Ce nom est directement utilisable avec la fonction DateHeureLocaleVersFuseau.

Nouveauté 20

Gestion des dates et de leur fuseau horaire

Suite à l'utilisation de l'authentification "OAuth 2.0", la gestion des dates a été modifiée. Toutes les dates renvoyées par les fonctions GglRécupèreAgenda, GglListeAgenda, ... dans les variables de type gglEvénement utilisent le fuseau horaire de la machine locale. Elles sont donc utilisables directement dans un champ Calendrier avec le fuseau horaire en cours.

Pour les convertir dans un fuseau horaire particulier, il est possible d'utiliser les fonctions DateHeureLocaleVersFuseau ou DateHeureLocaleVersUTC.

Il est possible de récupérer le fuseau horaire de l'agenda accédé via la propriété FuseauHoraire des variables de type gglAgenda. La valeur renvoyée correspond au nom du fuseau, issu de la base de données "tz" (ou base de données Olson). Ce nom est directement utilisable avec la fonction DateHeureLocaleVersFuseau.

Gestion des dates et de leur fuseau horaire

Suite à l'utilisation de l'authentification "OAuth 2.0", la gestion des dates a été modifiée. Toutes les dates renvoyées par les fonctions GglRécupèreAgenda, GglListeAgenda, ... dans les variables de type gglEvénement utilisent le fuseau horaire de la machine locale. Elles sont donc utilisables directement dans un champ Calendrier avec le fuseau horaire en cours.

Pour les convertir dans un fuseau horaire particulier, il est possible d'utiliser les fonctions DateHeureLocaleVersFuseau ou DateHeureLocaleVersUTC.

Il est possible de récupérer le fuseau horaire de l'agenda accédé via la propriété FuseauHoraire des variables de type gglAgenda. La valeur renvoyée correspond au nom du fuseau, issu de la base de données "tz" (ou base de données Olson). Ce nom est directement utilisable avec la fonction DateHeureLocaleVersFuseau.

Voir Aussi