PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

  • 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/iPadApple WatchUniversal Windows 10 AppWindows Mobile
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.
Versions 22 et supérieures
WINDEV MobileWidget Android Cette fonction est désormais disponible en mode Widget Android.
WINDEV MobileAndroid Cette fonction est désormais disponible pour les applications Android.
WINDEVJava Cette fonction est désormais disponible pour les applications Java.
WEBDEV - Code ServeurPHP Cette fonction est désormais disponible pour les sites PHP.
Nouveauté 22
WINDEV MobileWidget Android Cette fonction est désormais disponible en mode Widget Android.
WINDEV MobileAndroid Cette fonction est désormais disponible pour les applications Android.
WINDEVJava Cette fonction est désormais disponible pour les applications Java.
WEBDEV - Code ServeurPHP Cette fonction est désormais disponible pour les sites PHP.
WINDEV MobileWidget Android Cette fonction est désormais disponible en mode Widget Android.
WINDEV MobileAndroid Cette fonction est désormais disponible pour les applications Android.
WINDEVJava Cette fonction est désormais disponible pour les applications Java.
WEBDEV - Code ServeurPHP Cette fonction est désormais disponible pour les sites PHP.
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 (avec guillemets)
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 (avec guillemets)
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

Windows Mobile La fonction TraceConstruit est prise en compte aussi bien lors d'un test sous le simulateur que lors d'un test sur le Pocket PC. Dans ce dernier cas, les informations sont directement affichées sous l'environnement, dans le volet "Trace du débogueur".
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".
Versions 22 et supérieures
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.
Nouveauté 22
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.
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 ServeurWEBDEV - Code NavigateurWindows Mobile

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 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 NavigateurWindows Mobile

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.
Versions 22 et supérieures
PHP Si les fonctions PageAffiche et PageActualise sont utilisées, le moteur PHP affichera un message d'avertissement.
Nouveauté 22
PHP Si les fonctions PageAffiche et PageActualise sont utilisées, le moteur PHP affichera un message d'avertissement.
PHP Si les fonctions PageAffiche et PageActualise sont utilisées, le moteur PHP affichera un message d'avertissement.
Composantes
WINDEVWEBDEV - Code ServeurEtats et Requêtes wd220vm.dll
Windows Mobile wp220vm.dll
Java wd220java.jar
Linux wd220vm.so
Android wd220android.jar
Version minimum requise
  • Version 21
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire