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 Planning
  • Evénements gérés par défaut
  • Evénements gérés par WINDEV et WINDEV Mobile
  • Evénements gérés par WEBDEV
  • Evénements avec procédures
  • 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
WINDEVAndroidiPhone/iPad

Evénements gérés par WINDEV et WINDEV Mobile

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é :
  • WINDEV lors de la sélection de l'option "Nouveau rendez-vous" dans le menu contextuel du champ Planning.
  • lors de la saisie directe au clavier d'un nouveau rendez-vous.
AndroidiPhone/iPad Pour créer un rendez-vous (option "Autoriser la saisie directe d'un rendez-vous" dans l'onglet "Détail" de la fenêtre de description du champ) :
  • Cliquez sur le champ Planning : la période sélectionnée passe en surbrillance et un signe "+" est affiché.
  • Cliquez sur le signe "+" : l'événement "Avant création du rendez-vous" est exécuté. Le rendez-vous passé en paramètre contient les dates de début et de fin du rendez-vous. Si cet événement retourne rien ou Vrai, le rendez-vous est ajouté au champ Planning et l'affichage est mis à jour.
WINDEV Entrée en saisie du rendez-vous
Exécuté :
  • lors de la sélection de l'option "Nouveau rendez-vous" dans le menu contextuel du champ Planning.
  • lors de la saisie directe au clavier d'un nouveau rendez-vous.
Cet événement est exécuté immédiatement après l'événement "Avant création du rendez-vous".
WINDEV Sortie de saisie d'un rendez-vous
Exé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 Planning.
Déplacement d'un rendez-vousExécuté lors du déplacement d'un rendez-vous dans le champ Planning.
WINDEV Lors d'un déplacement à la souris, cet événement est exécuté à la fin du déplacement (sur le "lâcher" de la souris).
Remarque : Le déplacement effectué est annulé si cet événement exécute la ligne de code suivante :
RENVOYER Faux
AndroidiPhone/iPad Pour déplacer un rendez-vous, il est nécessaire d'effectuer un appui long : le rendez-vous passe alors en mode déplacement et peut être déplacé avec le doigt vers sa destination. Cet événement est exécuté à la fin du déplacement.
WINDEV Redimensionnement d'un rendez-vous
Exécuté lors du redimensionnement d'un rendez-vous dans le champ Planning (redimensionnement effectué à la souris par exemple). Cet événement est exécuté à la fin du redimensionnement (sur le "lâcher" de la souris).
WINDEV Suppression d'un rendez-vous
Exécuté :
  • lors de la sélection de l'option "Supprimer le rendez-vous" dans le menu contextuel du champ Planning.
  • lors de la suppression d'un rendez-vous effectué avec la touche SUPPR du clavier.
WINDEV Sélection d'une période
Exécuté lors de la sélection d'une plage horaire dans le champ Planning (clic sur une plage horaire par exemple). Lors de la sélection à la souris d'un ensemble de plages horaires, l'événement est exécuté pour chaque nouvelle plage sélectionnée.
A chaque changement de période
WINDEV Exécuté lors de la modification de la période affichée dans le champ Planning (utilisation des boutons fléchés en haut à gauche du champ Planning ou changement de la période par programmation grâce aux fonctions PlanningAffichePériodePrécédente et PlanningAffichePériodeSuivante).
AndroidiPhone/iPad Exécuté lors de la modification de la période affichée dans le champ Planning (balayage du champ Planning ou changement de la période par programmation grâce aux fonctions PlanningAffichePériodePrécédente et PlanningAffichePériodeSuivante).
Réaffectation d'un rendez-vousExécuté lorsque le déplacement d'un rendez-vous entraîne la modification de la ressource associée au rendez-vous.
WINDEV A chaque changement de mode d'affichage
Exécuté lorsque l'utilisateur change le mode d'affichage du champ Planning. Le nouveau mode peut être connu dans cet événement grâce à la fonction PlanningMode.

(*) 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 Serveur

Evénements gérés par WEBDEV

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 Planning. Lors d'un déplacement à la souris, cet événement est exécuté à la fin du déplacement (sur le "lâcher" de la souris).
Redimensionnement d'un rendez-vous (code serveur)Exécuté lors du redimensionnement d'un rendez-vous dans le champ Planning (redimensionnement effectué à la souris par exemple). Cet événement est exécuté à la fin du redimensionnement (sur le "lâcher" de la souris).
Suppression d'un rendez-vous (code serveur)Exécuté lors de la suppression du rendez-vous. Cette suppression est effectuée lors du clic sur l'icône de suppression du rendez-vous (la croix rouge) affichée à droite du rendez-vous sélectionné.
Avant création du rendez-vous (code serveur)Exécuté lors de la saisie directe au clavier d'un nouveau rendez-vous. Pour effectuer la saisie directe, il suffit de double-cliquer sur le rendez-vous et de saisir son titre.
Sortie de saisie d'un rendez-vous (code serveur)Exé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 exemple). Cette sortie correspond à l'appui sur la touche [ENTREE] pour valider la saisie.
A chaque changement de période (code serveur)Exécuté lors de la modification de la période affichée dans le champ Planning (utilisation des boutons fléchés en haut à gauche du champ Planning).
Réaffectation d'un rendez-vous (code serveur)Exécuté lorsque le déplacement d'un rendez-vous entraîne la modification de la ressource associée au rendez-vous.
Sélection d'un rendez-vous (code navigateur)Exécuté lors de la sélection d'un rendez-vous existant dans le champ Planning.
Déplacement d'un rendez-vous (code navigateur)Exécuté lors du déplacement d'un rendez-vous dans le champ Planning. Lors d'un déplacement à la souris, cet événement est exécuté à la fin du déplacement (sur le "lâcher" de la souris).
Redimensionnement d'un rendez-vous (code navigateur)Exécuté lors du redimensionnement d'un rendez-vous dans le champ Planning (redimensionnement effectué à la souris par exemple). Cet événement est exécuté à la fin du redimensionnement (sur le "lâcher" de la souris).
Sélection d'une période (code navigateur)Exécuté lors de la sélection d'une plage horaire dans le champ Planning.
Suppression d'un rendez-vous (code navigateur)Exécuté lors de la suppression du rendez-vous. Cette suppression est effectuée lors du clic sur l'icône de suppression du rendez-vous (la croix rouge) affichée à droite du rendez-vous sélectionné.
Avant création du rendez-vous (code navigateur)Exécuté lors de la saisie directe au clavier d'un nouveau rendez-vous. Pour effectuer la saisie directe, il suffit de double-cliquer sur le rendez-vous et de saisir son titre.
Entrée en saisie d'un rendez-vous (code navigateur)Exécuté lors de la saisie directe du rendez-vous. Pour effectuer la saisie directe, il suffit de double-cliquer sur le rendez-vous et de saisir son titre. Cet événement est exécuté 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 (sortie lors de l'ajout d'un rendez-vous ou lors de la modification d'un rendez-vous par exemple). Cette sortie correspond à l'appui sur la touche Entrée pour valider la saisie.
Réaffectation d'un rendez-vous (code navigateur)Exécuté lorsque le déplacement d'un rendez-vous entraîne la modification de la ressource associée au rendez-vous.
Evénements avec procédures
Pour simplifier la manipulation des rendez-vous d'un planning, 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 sont automatiquement affectées à cette variable.
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 "Sortie de saisie d'un rendez-vous" :
PROCÉDURE SortieDeSaisie(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. Il suffit pour cela de créer une fenêtre / page avec les informations à remplir.
Dans le code, il suffit d'ouvrir la fenêtre ou page par exemple dans l'événement "Entrée en saisie d'un rendez-vous". Pour bloquer la saisie directe par le menu contextuel du planning, l'événement doit alors renvoyer Faux.
WINDEV Ce principe peut être appliqué à tous les événements appelés par le menu contextuel du champ Planning.
WINDEV 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 Planning
RENVOYER Faux
Evénements optionnels
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 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