PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

  • Traitements gérés par défaut
  • Traitements optionnels
  • Filtrage des enregistrements (Table fichier uniquement)
  • Avant l'affichage de la bulle d'aide automatique de l'ascenseur
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Autres
Procédures stockées
Traitements gérés par défaut
WINDEVAndroidiPhone/iPadWindows MobileJava WINDEV et WINDEV Mobile gèrent par défaut les traitements suivants (ordre d'apparition sous l'éditeur de code) :
TraitementCondition d'exécution
InitialisationExécuté à l'ouverture de la fenêtre. (*)

Cas particulier : Table fichier remplie automatiquement
Lors de l'exécution de ce code, la table n'est pas encore remplie. Il est possible de forcer le remplissage de la table dans ce code avec :Exécuté à l'ouverture de la fenêtre. (*)

Cas particulier : Table fichier remplie automatiquement
Lors de l'exécution de ce code, la table n'est pas encore remplie. Il est possible de forcer le remplissage de la table dans ce code avec :Il est également possible de filtrer les enregistrements avec la fonction HFiltre.
Fin d'initialisationCode présent uniquement pour Table fichier remplie automatiquement :

Exécuté après le remplissage de la table. Ce code permet par exemple de sélectionner un élément dans la table, d'ajouter ou de modifier un élément.
Entrée dans la tableExécuté lorsque le champ prend le focus
Sortie de la tableExécuté lors du changement de champ (touche TAB, changement de champ par la souris, ...)
Entrée en saisie d'une ligne de la tableExécuté lorsque l'utilisateur sélectionne une ligne pour effectuer une saisie dans cette ligne.
Sortie d'une ligne de la tableExécuté lors du changement de ligne ou lors du changement de champ (touche TAB, changement de champ par la souris, ...) à partir d'une ligne.
Dans ce code, la ligne en cours correspond à la ligne précédemment sélectionnée.
Java Dans ce code, la ligne courante correspond à la nouvelle ligne sélectionnée.
Affichage d'une ligne de la tableExécuté lorsque une nouvelle ligne doit être affichée dans la table : ré-affichage de la table, scrolling ou déplacement dans la table, ...

Ce traitement est également exécuté lors de l'affectation d'une colonne. Si plusieurs colonnes sont affectées par programmation, le code d'affichage sera exécuté plusieurs fois.
Conseil : Si vous devez modifier plusieurs colonnes, utilisez la fonction TableModifieLigne et non l'affectation directe.
iPhone/iPad Ce traitement n'est pas disponible dans les champs Table fichier pour des raisons de performances.
Sélection d'une ligne de la tableExécuté lorsque l'utilisateur sélectionne une ligne (sans saisie).
Versions 16 et supérieures
Ce traitement est également exécuté lorsque l'utilisateur clique sur une cellule en mode de sélection "Cellule Sélection simple" ou "Cellule : Sélection multiple".
Nouveauté 16
Ce traitement est également exécuté lorsque l'utilisateur clique sur une cellule en mode de sélection "Cellule Sélection simple" ou "Cellule : Sélection multiple".
Ce traitement est également exécuté lorsque l'utilisateur clique sur une cellule en mode de sélection "Cellule Sélection simple" ou "Cellule : Sélection multiple".
Versions 20 et supérieures
AndroidiPhone/iPad Rafraîchissement par tirer/relâcher
Nouveauté 20
AndroidiPhone/iPad Rafraîchissement par tirer/relâcher
AndroidiPhone/iPad Rafraîchissement par tirer/relâcher
Ce traitement est automatiquement ajouté lorsque la fonctionnalité "Tirer pour rafraîchir" (Pull to Refresh) a été activée (onglet "Détail" de la fenêtre de description du champ Table).
Ce traitement est exécuté lors de la détection de la gesture de rafraîchissement sur le champ Table.
A la fin de ce traitement, le bandeau de rafraîchissement sera automatiquement masqué sauf si la fonction TableRafraîchissementVisible a été appelée.
WINDEViPhone/iPadWindows MobileJava Filtrage des enregistrements (traitement optionnel)
Code présent uniquement pour Table fichier remplie automatiquement :
Exécuté juste avant l'affichage d'une ligne. Ce traitement permet de filtrer les enregistrements à afficher dans la table. Ce traitement est détaillé à la fin de cette page.
WINDEVWindows Mobile Traitements de gestion du Drag and Drop (traitements optionnels)
Code présent uniquement pour Table mémoire et Table sur source :
Ces traitements permettent de simplifier la gestion du Drag and Drop programmé. Les traitements disponibles sont :
  • Début du glisser/déplacer source
  • Fin du glisser/déplacer source
  • Entrée en glisser/déplacer cible
  • Survol en glisser/déplacer cible
  • Lâcher en glisser/déplacer cible
  • Sortie en glisser/déplacer cible
Remarque : Si un de ces traitements contient du code, le Drag and Drop n'est plus automatiquement géré pour la table : il est nécessaire de gérer entièrement par programmation le Drag and Drop dans la table.

(*) Par défaut, le traitement "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. Sélectionnez l'option "Fenêtres .. Éditer l'ordre d'initialisation".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 traitements suivants (ordre d'apparition sous l'éditeur de code) :
TraitementCondition d'exécution
Initialisation (Code serveur)Exécuté à l'ouverture de la page.
Cas particulier : Table fichier remplie automatiquement :
Lors de l'exécution de ce code, le champ Table n'est pas encore rempli. Il est possible de forcer le remplissage du champ dans ce code avec :
Il est également possible de filtrer les enregistrements avec la fonction HFiltre.
Fin d'initialisation (Code serveur)Code présent uniquement pour un champ Table fichier remplie automatiquement :
Exécuté après le remplissage du champ Table. Ce code permet par exemple de sélectionner un élément dans le champ Table, d'ajouter ou de modifier un élément.
Sélection d'une ligne (Code serveur)Code exécuté lorsque l'internaute sélectionne une ligne du champ Table.
Sélection d'une ligne (Code navigateur)Table en mode AJAX
Exécuté lorsque l'utilisateur sélectionne une ligne (sans saisie).
Versions 19 et supérieures
Table en mode Navigateur
Exécuté lorsque l'utilisateur sélectionne une ligne (sans saisie)
Nouveauté 19
Table en mode Navigateur
Exécuté lorsque l'utilisateur sélectionne une ligne (sans saisie)
Table en mode Navigateur
Exécuté lorsque l'utilisateur sélectionne une ligne (sans saisie)
Affichage d'une ligne (Code serveur)Exécuté lorsque une nouvelle ligne doit être affichée dans le champ Table : ré-affichage du champ Table, scrolling ou déplacement dans le champ Table, ...
Permet de gérer les colonnes calculées.
Versions 19 et supérieures
Affichage d'une ligne (Code navigateur)
Nouveauté 19
Affichage d'une ligne (Code navigateur)
Affichage d'une ligne (Code navigateur)
Versions 19 et supérieures
Table en mode Navigateur uniquement
Exécuté lorsque une nouvelle ligne doit être affichée dans le champ Table : ré-affichage du champ Table, scrolling ou déplacement dans le champ Table, ...
Nouveauté 19
Table en mode Navigateur uniquement
Exécuté lorsque une nouvelle ligne doit être affichée dans le champ Table : ré-affichage du champ Table, scrolling ou déplacement dans le champ Table, ...
Table en mode Navigateur uniquement
Exécuté lorsque une nouvelle ligne doit être affichée dans le champ Table : ré-affichage du champ Table, scrolling ou déplacement dans le champ Table, ...
Clic de table (Code navigateur)Exécuté lorsque l'internaute sélectionne une ligne.
Sortie d'une ligne (Code serveur)Table en mode AJAX uniquement
Exécuté lors du changement de ligne ou lors du changement de champ (touche TAB, changement de champ par la souris, ...) à partir d'une ligne
Filtrage des enregistrements (Code serveur)Code présent uniquement pour Table fichier remplie automatiquement :
Exécuté juste avant l'affichage d'une ligne. Ce traitement permet de filtrer les enregistrements à afficher dans la table. Ce traitement est détaillé à la fin de cette page.
Traitements optionnels
Plusieurs traitements optionnels peuvent être gérés.
Pour gérer un traitement optionnel, il suffit de le sélectionner dans la barre d'icônes de la fenêtre de code.
WINDEV et WINDEV Mobile (Projets Windows Mobile)
WINDEV et WINDEV Mobile (Projets Windows Mobile)
WEBDEV
WEBDEV
Pour ajouter un traitement 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 traitements à xxx" situé à la fin de la fenêtre de code, après le dernier traitement.
  4. La totalité des traitements optionnels disponibles pour le champ est affichée.
  5. Cochez le traitement optionnel à ajouter et validez.
    Remarque : Il est possible de sélectionner plusieurs traitements optionnels.
  6. Le traitement optionnel sélectionné est automatiquement ajouté dans les traitements gérés par le champ.
Pour désactiver un traitement optionnel, il suffit d'effectuer les mêmes manipulations pour afficher la liste des traitements optionnels. Il suffit ensuite de décocher les traitements 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, ...
Remarque : Selon l'environnement (WINDEV, WEBDEV, WINDEV Mobile) et la plateforme de développement, les traitements optionnels disponibles ne sont pas les mêmes.
Filtrage des enregistrements (Table fichier uniquement)
WINDEVWEBDEV - Code ServeurWindows MobilePHP Le traitement "Filtrage des enregistrements" est exécuté juste après l'affichage d'une ligne de la table. Il est donc exécuté :
  • lors de l'initialisation de la table.
  • à chaque nouvel affichage d'une ligne de la table.
Ce traitement permet de filtrer les enregistrements affichés dans la table.
Pour mettre en place un filtre, le traitement "Filtrage des enregistrements" doit renvoyer une valeur :
  • Vrai pour signifier que l'enregistrement respecte le filtre et qu'il doit être affiché.
  • Faux pour signifier que l'enregistrement ne respecte pas le filtre et qu'il ne doit pas être affiché.
  • Annuler pour arrêter la lecture de la source de données de la table (cas très rare).
Exemple :
// -- Filtrage des enregistrements
// Affiche uniquement les clients dont commandes sont supérieures à 3000 euros
SI Commande.TotalTTC >=3000 ALORS
        RENVOYER Vrai
SINON
        RENVOYER Faux
FIN
Dans ce code, les données manipulées concernent l'enregistrement en cours de lecture par la table. Ces données proviennent du fichier ou de la requête liés au champ Table.
WINDEVWINDEV Mobile Si un filtre automatique est réalisé sur le champ Table (fonction TableActiveFiltre ou filtre activé directement par l'utilisateur), le filtre défini par le traitement "Filtrage des enregistrements" se cumule au filtre automatique.
Remarque : Sous WINDEV et WINDEV Mobile, le traitement "Filtrage des enregistrements" est un traitement optionnel. Sous WEBDEV, ce traitement est proposé par défaut.
Avant l'affichage de la bulle d'aide automatique de l'ascenseur
Versions 17 et supérieures
WINDEV Sous Windows, la bulle d'aide de l'ascenseur des champs Table est affichée lorsque l'utilisateur clique sur la "cage" de l'ascenseur vertical.
Cette bulle d'aide contient par défaut les informations suivantes :
  • Plage des lignes actuellement affichées dans le champ Table.
  • Nombre de lignes total du champ Table.
  • Information sur l’élément actuellement affiché en première ligne du champ Table dans la colonne triée.
Le traitement "Avant l'affichage de la bulle d'aide automatique de l'ascenseur" est exécuté juste avant l'affichage de cette bulle d'aide. Il est ainsi possible par exemple d'afficher un texte spécifique dans la bulle d'aide à l'aide de la propriété ..Bulle.
Nouveauté 17
WINDEV Sous Windows, la bulle d'aide de l'ascenseur des champs Table est affichée lorsque l'utilisateur clique sur la "cage" de l'ascenseur vertical.
Cette bulle d'aide contient par défaut les informations suivantes :
  • Plage des lignes actuellement affichées dans le champ Table.
  • Nombre de lignes total du champ Table.
  • Information sur l’élément actuellement affiché en première ligne du champ Table dans la colonne triée.
Le traitement "Avant l'affichage de la bulle d'aide automatique de l'ascenseur" est exécuté juste avant l'affichage de cette bulle d'aide. Il est ainsi possible par exemple d'afficher un texte spécifique dans la bulle d'aide à l'aide de la propriété ..Bulle.
WINDEV Sous Windows, la bulle d'aide de l'ascenseur des champs Table est affichée lorsque l'utilisateur clique sur la "cage" de l'ascenseur vertical.
Cette bulle d'aide contient par défaut les informations suivantes :
  • Plage des lignes actuellement affichées dans le champ Table.
  • Nombre de lignes total du champ Table.
  • Information sur l’élément actuellement affiché en première ligne du champ Table dans la colonne triée.
Le traitement "Avant l'affichage de la bulle d'aide automatique de l'ascenseur" est exécuté juste avant l'affichage de cette bulle d'aide. Il est ainsi possible par exemple d'afficher un texte spécifique dans la bulle d'aide à l'aide de la propriété ..Bulle.
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire