DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Fonctions standard / Fonctions de gestion de Windows / Fonctions diverses WINDEV
  • Conditions d'utilisation selon les plateformes
  • Fenêtre de trace
  • Menu contextuel de la fenêtre de trace
  • Cas particulier
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
Affiche des informations demandées (contenu d'un champ par exemple) dans une fenêtre ouverte en parallèle de la fenêtre en cours.
Fenêtre de trace
Remarques :
  • La fonction Trace est utile en phase de développement pour vérifier le bon déroulement du programme. Sous l'éditeur, le volet "Trace du débogueur" affiche les informations contenues dans la fenêtre de trace ainsi que le texte complet des erreurs rencontrées.
  • La fenêtre de trace s'affiche aussi bien en mode développement qu'en exécution. Pour éviter un affichage en exécution, utilisez la fonction EnModeTest.
Exemple
// ------------------
// Affichage d'informations dans la fenêtre de trace 
Trace("Résultat du calcul : " + ResCalcul)
// ----------------
// Surcharge de l'affichage de la trace
PROCÉDURE Trace(MessageAAfficher)
SI EnModeTest() ALORS Trace(MessageAAfficher)
// Appel de la fonction Trace surchargée
WL.Trace("Lancement de la trace")
Syntaxe
Trace(<Informations> [, <Informations complémentaires 1> [... [, <Informations complémentaires N>]]])
<Informations> : Tout type
Ensemble des éléments à afficher dans la fenêtre de trace.
<Informations complémentaires 1> : Tout type (optionnel)
Élément supplémentaire à afficher dans la fenêtre de trace. Sera affiché sur la même ligne que <Informations>.
<Informations complémentaires N> : Tout type (optionnel)
Élément supplémentaire à afficher dans la fenêtre de trace. Sera affiché sur la même ligne que <Informations>.
Remarques

Conditions d'utilisation selon les plateformes

Linux La fonction Trace permet d'afficher les informations demandées uniquement dans un fichier. Par défaut, ce fichier est créé dans le répertoire temporaire d'UNIX, sous le nom "Trace_<Projet>.txt".
PHP Les informations de la fonction Trace sont affichées au début de la page HTML renvoyée.
WEBDEV - Code Serveur
  • La fenêtre de trace est affichée uniquement en Go pour les pages dynamiques (non AWP).
  • En mode AWP et en déploiement, la fonction Trace permet uniquement d'écrire les informations spécifiées dans un fichier (constante trFichier utilisée avec la fonction TraceDébut).
iPhone/iPadWidget IOSApple WatchMac Catalyst La fonction Trace affiche des informations demandées dans la fenêtre de sortie standard (output) de Xcode.
AndroidWidget Android La fonction Trace permet d'enregistrer les informations demandées uniquement dans le log de l'application (appelé "log ADB") en exécution ou en mode émulateur). Ces informations sont présentes au niveau "Info".
Ce log est consultable lorsque l'appareil est connecté en USB ou en cas d'utilisation de l'émulateur depuis l'application DDMS fournie avec le SDK Android.
Pour plus de détails, consultez Gestion des logs ADB.
WINDEVWEBDEV - Code ServeurWEBDEV - Code Navigateur

Fenêtre de trace

  • Les informations passées en paramètre sont affichées sur la ligne suivante de la fenêtre de trace.
  • La fenêtre de trace est ouverte automatiquement dès le premier appel à la fonction Trace (la fonction TraceDébut est exécutée automatiquement). Par défaut, cette fenêtre est ouverte en haut, à gauche de l'écran.
  • Le fonctionnement de la fonction Trace est similaire à celui de la fonction Info mais l'affichage s'effectue dans une fenêtre parallèle, sans attente de touche.
  • WEBDEV - Code ServeurWEBDEV - Code Navigateur La fenêtre de trace affichée depuis un code navigateur est différente de celle affichée depuis un code serveur. Deux fenêtres de trace différentes peuvent donc être ouvertes en même temps.
WINDEVWEBDEV - Code ServeurWEBDEV - Code Navigateur

Menu contextuel de la fenêtre de trace

Le menu contextuel de la fenêtre de trace permet de :
  • copier/couper/coller le contenu de la fenêtre de trace.
  • enregistrer le contenu de la fenêtre de trace dans un fichier texte.
    Attention : Cette option est disponible uniquement si la librairie wdxxxstd.dll est présente sur le poste de l'utilisateur final.
  • vider le contenu de la fenêtre de trace.
  • ouvrir la fenêtre de trace au-dessus de toutes les autres fenêtres (y compris les fenêtres des autres applications).
  • mémoriser la taille et la position de la fenêtre de trace lors de sa fermeture. Lors du ré-affichage de cette fenêtre, la fenêtre s'affichera selon la taille et la position mémorisées.
  • afficher un ascenseur horizontal.
  • afficher les caractères spéciaux en gris et en littéral : EOT, TAB, etc. Ainsi, les caractères "Retour Chariot" (RC) présents dans la fenêtre de trace correspondent en littéral à "<\r><\n>".
    Remarque : Cette option sera prise en compte uniquement à partir de la prochaine ligne d'informations affichée.
WEBDEV - Code Serveur

Cas particulier

Les fonctions PageAffiche et PageActualise ne peuvent pas être utilisées après la fonction Trace.
PHP Si les fonctions PageAffiche et PageActualise sont utilisées, le moteur PHP affichera un message d'avertissement.
Composante : wd290vm.dll
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Trace en mode test
un problème de la fonction Trace() c'est qu'elle se compile et s'exécute en mode développement et en mode exécution.
Préférez l'utilisation d'une fonction personnelle TraceEnModeTest() pour ne pas avoir à corriger votre code avant livraison.

Procedure TraceModeTest(Str_Message)

SI EnModeTest() ALORS Trace(Str_Message)

bernard SOBRA
18 juin 2023

Dernière modification : 07/03/2024

Signaler une erreur ou faire une suggestion | Aide en ligne locale