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 TimeLine
  • Evénements gérés par défaut
  • 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
WINDEV gère 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 de l'événementExécuté :
  • lors de la sélection de l'option "Nouvel événement" dans le menu contextuel du champ TimeLine.
  • lors de la saisie directe au clavier d'un nouvel événement.
Entrée en saisie d'un événementExécuté :
  • lors de la sélection de l'option "Nouvel événement" dans le menu contextuel du champ TimeLine.
  • lors de la saisie directe au clavier d'un nouvel événement.
Cet événement est exécuté immédiatement après l'événement "Avant création de l'événement".
Sortie de saisie de l'événementExécuté lors de la sortie de la saisie d'un événement (sortie lors de l'ajout d'un événement ou lors de la modification d'un événement par le menu contextuel par exemple).
Sélection d'un événementExécuté lors de la sélection d'un événement existant dans le champ TimeLine.
Déplacement d'un événementExécuté lors du déplacement d'un événement dans le champ TimeLine. 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 événementExécuté lors du redimensionnement d'un événement dans le champ TimeLine (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 événementExécuté :
  • lors de la sélection de l'option "Supprimer l'événement" dans le menu contextuel du champ TimeLine.
  • lors de la suppression d'un événement effectué avec la touche SUPPR du clavier.
Sélection d'une périodeExécuté lors de la sélection d'une plage horaire dans le champ TimeLine (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.
Réaffectation d'un événementExécuté lorsque le déplacement d'un événement entraîne la modification de la piste associée à l'événement.
A chaque ModificationExécuté lors du déplacement de la réglette dans le champ TimeLine.

(*) 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.
Evénements avec procédures
Pour simplifier la manipulation des événements d'un champ TimeLine, des procédures sont proposées dans chaque événement. Ces procédures prennent en paramètre directement la variable de type EvénementTimeline à manipuler. Toutes les informations de l'événement manipulé par le menu contextuel sont automatiquement affectées à cette variable.
Exemple : Pour mémoriser dans un fichier de données EVT, un événement que l'utilisateur ajoute via le menu contextuel, il suffit de saisir le code suivant dans l'événement "Sortie de saisie de l'événement" :
PROCÉDURE SortieDeSaisie(evtModifie est un EvénementTimeline)
 
// Mémorisation des données
EVT.Titre = evtModifie.Titre
EVT.EvtDébut = evtModifie.Début
EVT.EvtFin = evtModifie.Fin
...
HAjoute(EVT)

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 événement lors d'un ajout ou d'une modification. 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 événement". Pour bloquer la saisie directe par le menu contextuel du champ TimeLine, l'événement doit alors renvoyer Faux.
Ce principe peut être appliqué à tous les événements appelés par le menu contextuel du champ TimeLine.
Exemple :
PROCÉDURE Edition(evtEdité est un EvénementTimeline)
 
// Ouvre la fenêtre de saisie d'un événement
// avec l'événement sélectionné (en mode Création ou Modification)
Ouvre(FEN_SaisieEVT_HFSQL, evtEdité)
 
// Renvoie FAUX pour bloquer la saisie directe dans le champ TimeLine
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 18
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