DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / Développer une application ou un site / Champs, fenêtres et pages / Champs : Types disponibles / Champ Agenda
  • Evénements gérés par défaut (champ d'une fenêtre)
  • Des événements avec procédures pour une utilisation rapide
  • Utilisation avancée des événements avec procédure
  • Evénements optionnels
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
Evénements gérés par défaut (champ d'une fenêtre)
WINDEVAndroidiPhone/iPad WINDEV et WINDEV Mobile gèrent par défaut les événements suivants (ordre d'apparition sous l'éditeur de code) :
EvénementCondition d'exécution
InitialisationExécuté à l'ouverture de la fenêtre. *
Avant création du rendez-vousExécuté lors de la sélection de l'option "Nouveau rendez-vous" dans le menu contextuel du champ Agenda.
Entrée en saisie d'un rendez-vousExécuté lors de la sélection de l'option "Nouveau rendez-vous" dans le menu contextuel du champ Agenda. Cet événement est exécuté immédiatement après l'événement "Avant création du rendez-vous".
Sortie de saisie d'un rendez-vousExécuté lors de la sortie de la saisie d'un rendez-vous (sortie lors de l'ajout d'un rendez-vous ou lors de la modification d'un rendez-vous par le menu contextuel par exemple).
Sélection d'un rendez-vousExécuté lors de la sélection d'un rendez-vous existant dans le champ Agenda. Cet événement est exécuté lors de l'ouverture du menu contextuel.
Déplacement d'un rendez-vousExécuté lors du déplacement d'un rendez-vous dans le champ Agenda (déplacement effectué à la souris par exemple).
Redimensionnement d'un rendez-vousExécuté lors du redimensionnement d'un rendez-vous dans le champ Agenda (redimensionnement effectué à la souris par exemple).
Suppression d'un rendez-vousExécuté lors de la sélection de l'option "Supprimer le rendez-vous" dans le menu contextuel du champ Agenda.
Sélection d'une périodeExécuté lors de la sélection d'une plage horaire dans le champ Agenda.
A chaque changement de périodeExécuté lors de la modification de la période affichée dans le champ Agenda.
A chaque changement de mode d'affichageExécuté lorsque l'utilisateur change le mode d'affichage du champ Agenda. Le nouveau mode peut être connu dans cet événement grâce à la fonction AgendaMode.

(*) Par défaut, l'événement "Initialisation" de chaque champ est exécuté selon l'ordre de création des différents champs dans la fenêtre. Pour modifier cet ordre d'exécution :
  1. Sous le volet "Fenêtre", dans le groupe "Ordre", cliquez sur "Initialisation".
  2. Dans la fenêtre qui s'affiche, utilisez les flèches situées sur la droite pour modifier l'ordre d'initialisation des champs.
WEBDEV - Code ServeurWEBDEV - Code NavigateurPHP WEBDEV gère par défaut les événements suivants (ordre d'apparition sous l'éditeur de code) :
EvénementCondition d'exécution
Initialisation (code serveur)Exécuté à l'ouverture de la page.
Déplacement d'un rendez-vous (code serveur)Exécuté lors du déplacement d'un rendez-vous dans le champ Agenda (déplacement effectué à la souris par exemple).
Redimensionnement d'un rendez-vous (code serveur)Exécuté lors du redimensionnement d'un rendez-vous dans le champ Agenda (redimensionnement effectué à la souris par exemple).
Suppression d'un rendez-vous (code serveur)Exécuté lors du clic sur la croix présente en haut à droite du rendez-vous sélectionné.
Avant création du rendez-vous (code serveur)Exécuté lors de la création d'un rendez-vous à la souris (avant la saisie par l'utilisateur).
Sortie de saisie d'un rendez-vous (code serveur)Exécuté lors de la sortie de la saisie d'un rendez-vous.
A chaque changement de période (code serveur)Exécuté lors de la modification de la période affichée dans le champ Agenda.
Sélection d'un rendez-vous (code navigateur)Exécuté lors de la sélection d'un rendez-vous existant dans le champ Agenda. Cet événement est exécuté lors du clic sur un rendez-vous.
Déplacement d'un rendez-vous (code navigateur)Exécuté lors du déplacement d'un rendez-vous dans le champ Agenda (déplacement effectué à la souris par exemple).
Redimensionnement d'un rendez-vous (code navigateur)Exécuté lors du redimensionnement d'un rendez-vous dans le champ Agenda (redimensionnement effectué à la souris par exemple).
Sélection d'une période (code navigateur)Exécuté lors de la sélection d'une plage horaire dans le champ Agenda.
Suppression d'un rendez-vous (code navigateur)Exécuté lors du clic sur la croix présente en haut à droite du rendez-vous sélectionné.
Avant création du rendez-vous (code navigateur)Exécuté lors de la création d'un rendez-vous à la souris (avant la saisie par l'utilisateur).
Entrée en saisie d'un rendez-vous (code navigateur)Exécuté lors de la sélection de l'option "Nouveau rendez-vous" dans le menu contextuel du champ Agenda. Cet événement est exécuté immédiatement après l'événement "Avant création du rendez-vous".
Sortie de saisie du rendez-vous (code navigateur)Exécuté lors de la sortie de la saisie d'un rendez-vous.
A chaque changement de période (code navigateur)Exécuté lors de la modification de la période affichée dans le champ Agenda.

Des événements avec procédures pour une utilisation rapide

La majorité des événements associés au champ Agenda sont des événements exécutés :
  • WINDEV lors de l'utilisation du menu contextuel du champ Agenda.
  • lors de l'utilisation de la souris ou du doigt.
  • WEBDEV - Code ServeurPHP lors de l'utilisation de la croix de suppression.
Pour simplifier la manipulation des rendez-vous d'un champ Agenda, des procédures sont proposées dans chaque événement. Ces procédures prennent en paramètre directement la variable rendez-vous (variable de type RendezVous) à manipuler. Toutes les informations du rendez-vous manipulé par le menu contextuel, par la souris ou le doigt sont automatiquement affectées à cette variable.
WINDEV Exemple : Pour mémoriser dans un fichier de données RDV, un rendez-vous que l'utilisateur ajoute via le menu contextuel, il suffit de saisir dans l'événement "Entrée en saisie d'un rendez-vous" :
PROCÉDURE Edition(rdvEdité est un RendezVous)

// Mémorisation des données
RDV.Titre = rdvEdité.Titre
RDV.DateDébut = rdvEdité.DateDébut
RDV.DateFin = rdvEdité.DateFin
...
HAjoute(RDV)

Utilisation avancée des événements avec procédure

Il est également possible de proposer à l'utilisateur de définir plus précisément les caractéristiques de son rendez-vous lors d'un ajout ou d'une modification.
WINDEVAndroidiPhone/iPad Il suffit pour cela de créer une fenêtre avec les informations à remplir.
Dans le code, il suffit d'ouvrir la fenêtre par exemple dans l'événement "Entrée en saisie d'un rendez-vous". Pour bloquer la saisie directe par le menu contextuel du champ Agenda, l'événement doit alors renvoyer Faux.
Ce principe peut être appliqué à tous les événements appelés par le menu contextuel du champ Agenda.
Exemple :
PROCÉDURE Edition(rdvEdité est un RendezVous)

// Ouvre la fenêtre de saisie d'un rendez-vous 
// avec le rendez-vous sélectionné (en mode Création ou Modification)
Ouvre(FEN_SaisieRDV_HFSQL, rdvEdité)

// Renvoie FAUX pour bloquer la saisie directe dans le champ Agenda
RENVOYER Faux
WEBDEV - Code ServeurWEBDEV - Code NavigateurPHP Il suffit pour cela de créer une popup avec les informations à remplir.
Dans le code, il suffit d'ouvrir la popup par exemple dans l'événement navigateur "Entrée en saisie d'un rendez-vous".
Exemple :
PROCÉDURE EntreeEnSaisie(rdvEdite est un RendezVous)

// Ouverture de la PopUp d'édition
POPUP_Modification.SAI_Titre = rdvEdite.Titre
POPUP_Modification.SAI_Contenu = rdvEdite.Contenu

SI rdvEdite.Catégorie = "Personnel" ALORS
	POPUP_Modification.COMBO_Catégorie = 1
SINON
	POPUP_Modification.COMBO_Catégorie = 2
FIN

SI rdvEdite.ID = 0 ALORS
	POPUP_Modification.BTN_Supprimer.Visible = Faux
FIN

PopupAffiche(POPUP_Modification)
Evénements optionnels
WINDEVAndroidiPhone/iPad Plusieurs événements optionnels peuvent être gérés. Pour ajouter un événement optionnel :
  1. Sélectionnez le champ voulu.
  2. Affichez la fenêtre de code de ce champ (touche F2).
  3. Cliquez sur le lien "Ajouter d'autres événements à xxx" situé à la fin de la fenêtre de code, après le dernier événement.
  4. La totalité des événements optionnels disponibles pour le champ est affichée.
  5. Cochez l'événement optionnel à ajouter et validez.
    Remarque : Il est possible de sélectionner plusieurs événements optionnels.
  6. L'événement optionnel sélectionné est automatiquement ajouté dans les événements gérés par le champ.
Pour désactiver un événement optionnel, il suffit d'effectuer les mêmes manipulations pour afficher la liste des événements optionnels. Il suffit ensuite de décocher les événements optionnels à supprimer.
Remarque : Si le code désactivé contient du code WLangage, ce code est automatiquement supprimé.
Il est ainsi possible de gérer par exemple :
  • le survol du champ par la souris,
  • le bouton gauche enfoncé, relâché, avec un double-clic,
  • le bouton droit enfoncé, relâché, avec double-clic,
  • la roulette de la souris, ...
Pour plus de détails, consultez les Evénements optionnels.
Version minimum requise
  • Version 15
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