DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Fonctions standard / Fonctions de gestion de Windows / Fonctions diverses WINDEV
  • Utilisation de la fonction TraceConstruit dans les applications multilingues
  • 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 un message paramétrable dans la fenêtre de trace ouverte en parallèle de la fenêtre en cours.
Remarque : Comme la fonction Trace, la fonction TraceConstruit 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.
Exemple
// Affichage du message d'erreur dans la fenêtre de trace
TraceConstruit("Le code client %1 n'existe pas.", nCodeClient)
Syntaxe
TraceConstruit(<Chaîne initiale> [, <Paramètre 1> [... [, <Paramètre N>]]])
<Chaîne initiale> : Chaîne de caractères
Chaîne de caractères à afficher. Cette chaîne contient des paramètres optionnels (caractères %1 à %n). Pour afficher le caractère %, il est nécessaire de doubler ce caractère (%%).
<Paramètre 1> : Chaîne de caractères optionnelle
Premier paramètre à insérer dans la chaîne de caractères formatée.
Le <Paramètre 1> remplacera le caractère %1, le <Paramètre 2> remplacera le caractère %2, etc.
Le nombre de paramètres spécifiés doit être identique ou supérieur au nombre de paramètres utilisés dans la chaîne de caractères <Chaîne initiale>.
Si la chaîne de caractères <Chaîne initiale> contient plus de paramètres, les paramètres supplémentaires seront remplacés par des chaînes vides.
<Paramètre N> : Chaîne de caractères optionnelle
Nième paramètres à insérer dans la chaîne de caractères formatée.
Le <Paramètre 1> remplacera le caractère %1, le <Paramètre 2> remplacera le caractère %2, etc.
Le nombre de paramètres spécifiés doit être identique ou supérieur au nombre de paramètres utilisés dans la chaîne de caractères <Chaîne initiale>.
Si la chaîne de caractères <Chaîne initiale> contient plus de paramètres, les paramètres supplémentaires seront remplacés par des chaînes vides.
Remarques

Utilisation de la fonction TraceConstruit dans les applications multilingues

Dans une application multilingue, l'utilisation de la fonction TraceConstruit permet de simplifier la traduction :
  • le traducteur traduit le message en positionnant les caractères "%1", "%2", ... à l'endroit voulu par la langue.
  • les caractères optionnels peuvent être remplacés dans toutes les langues gérées.

Conditions d'utilisation selon les plateformes

Linux La fonction TraceConstruit 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 TraceConstruit sont affichées au début de la page HTML renvoyée.
AndroidWidget Android La fonction TraceConstruit permet d'enregistrer les informations demandées uniquement dans le log de l'application (en exécution ou en mode émulateur). 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.
WEBDEV - Code Serveur En mode AWP, la fonction TraceConstruit permet d'afficher les informations demandées uniquement dans un fichier (constante trFichier utilisée avec la fonction TraceDébut).
iPhone/iPadApple Watch La fonction TraceConstruit affiche des informations demandées dans la fenêtre de sortie standard (output) de Xcode.
WINDEVWEBDEV - Code Serveur

Fenêtre de trace

  • La fenêtre de trace est ouverte automatiquement dès le premier appel à la fonction TraceConstruit (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 TraceConstruit est similaire à celui de la fonction InfoConstruit mais l'affichage s'effectue dans une fenêtre parallèle, sans attendre une validation par l'utilisateur.
  • WEBDEV - Code Serveur 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 Serveur

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 correspondent à "<\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 TraceConstruit.
PHP Si les fonctions PageAffiche et PageActualise sont utilisées, le moteur PHP affichera un message d'avertissement.
Composante : wd300vm.dll
Version minimum requise
  • Version 21
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