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 Tableau de bord
  • Evénements gérés par défaut
  • Evénements avec procédures
  • Evénements optionnels
  • Evénements optionnels des Widgets
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 associés à un champ Tableau de bord
Evénements gérés par défaut
WINDEVAndroidiPhone/iPadMac Catalyst 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. *
Les Widgets ajoutés par programmation doivent être ajoutés dans cet événement (fonction TDBAjouteWidget puis fonction TDBConfigurationInitiale).
Ajout d'un WidgetExécuté après l'ajout d'un Widget via le menu contextuel du champ Tableau de bord en mode édition.
Suppression d'un WidgetExécuté lors du masquage d'un Widget via le menu contextuel du champ Tableau de bord en mode édition.
  • Si cet événement ne renvoie pas de valeur ou renvoie Vrai, le Widget sera masqué.
  • Si cet événement renvoie Faux, le Widget ne sera pas masqué.
Déplacement d'un WidgetExécuté après le déplacement d'un Widget du champ Tableau de bord en mode édition.
Changement de taille d'un WidgetExécuté après la modification de la taille d'un Widget du champ Tableau de bord en mode édition.

(*) 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 Navigateur 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 page.
Les Widgets ajoutés par programmation doivent être ajoutés dans cet événement (fonction TDBAjouteWidget puis fonction TDBConfigurationInitiale).
Ajout d'un Widget (Navigateur)Exécuté après l'ajout d'un Widget via le menu contextuel du champ Tableau de bord en mode édition.
Ajout d'un Widget (Serveur)Exécuté après l'ajout d'un Widget via le menu contextuel du champ Tableau de bord en mode édition.
Suppression d'un Widget (Navigateur)Exécuté lors du masquage d'un Widget via le menu contextuel du champ Tableau de bord en mode édition.
  • Si cet événement ne renvoie pas de valeur ou renvoie Vrai, l'événement "Suppression d'un Widget (Serveur)" est exécuté.
  • Si cet événement renvoie Faux, le Widget ne sera pas masqué.
Suppression d'un Widget (Serveur)Exécuté lors du masquage d'un Widget via le menu contextuel du champ Tableau de bord en mode édition, après l'événement "Suppression d'un Widget (Navigateur)".
  • Si cet événement ne renvoie pas de valeur ou renvoie Vrai, le Widget sera masqué.
  • Si cet événement renvoie Faux, le Widget ne sera pas masqué.
Déplacement d'un Widget (Navigateur)Exécuté après le déplacement d'un Widget du champ Tableau de bord en mode édition.
Déplacement d'un Widget (Serveur)Exécuté après le déplacement d'un Widget du champ Tableau de bord en mode édition.
Changement de taille d'un Widget (Navigateur)Exécuté après la modification de la taille d'un Widget du champ Tableau de bord en mode édition.
Changement de taille d'un Widget (Serveur)Exécuté après la modification de la taille d'un Widget du champ Tableau de bord en mode édition.
Evénements avec procédures
Pour simplifier la manipulation des Widgets d'un champ Tableau de bord, des procédures sont proposées dans chaque événement. Ces procédures prennent en paramètre directement la variable Widget à manipuler. Cette variable est une variable de type Champ. Le Widget peut être manipulé directement par cette variable.
Exemple : Pour connaître les Widgets supprimés par l'utilisateur :
WINDEV
PROCÉDURE SuppressionWidget(Widget est un Champ)
Trace("Suppression" + Widget.Libellé)
Trace("Suppression" + Widget.FenêtreSource)
WEBDEV - Code Serveur
PROCÉDURE SuppressionWidget(Widget est un Champ)
Trace("Suppression" + Widget.Libellé)
Trace("Suppression" + Widget.PageSource)
AndroidiPhone/iPadMac Catalyst
PROCÉDURE SuppressionWidget(Widget)
Trace("Suppression" + Widget.Libellé)
Trace("Suppression" + Widget.FenêtreSource)
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.
Evénements optionnels des Widgets
Les Widgets sont des fenêtres internes affichées dans un champ Tableau de bord.
Dans ce cas, un événement optionnel spécifique peut être associé à la fenêtre ou la page interne : "Rafraîchissement du Widget".
Cet événement est exécuté lors de l'exécution de la fonction TDBAffiche.
Version minimum requise
  • Version 19
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