TraceStart (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

This content has been translated automatically. Click here to view the French version.

Help / WLanguage / WLanguage functions / Standard functions / Windows functions / Miscellaneous WINDEV functions

Use conditions according to the platforms
Closing the trace window
Trace window

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

TraceStart (Function)

In french: TraceDébut

Warning
From version 17 (78), StartTrace is kept for backward compatibility. This function has been replaced with TraceStart.

Opens the trace window or saves the trace information in a text file.

Remarks:

TraceStart has no effect if the trace window is already opened.
TraceStart is optional. The first call to Trace or to TraceBuild automatically opens the trace window.

Example

// Ouvre la fenêtre de trace
TraceStart()
...
// Ecrit dans la fenêtre de trace
Trace("Résultat du calcul : " + ResCalcul)

// Désactiver les appels à la fonction Trace
TraceStart(trDisable)
...
Trace("Résultat du calcul : " + ResCalcul) // Fonction Trace sans effet

// Enregistre les informations contenues dans 
// la fenêtre de trace dans le fichier "C:\Trace\MonFichier.txt"
TraceStart(trFile, "C:\Trace\MonFichier.txt")
...
Trace("Résultat du calcul : " + ResCalcul) 
// Aucune fenêtre de trace n'est affichée
// Cette information sera enregistrée dans le fichier "C:\Trace\MonFichier.txt"

Syntax

TraceStart([<Characteristic>])

<Characteristic>: Optional constant

Trace characteristics:
trConsole The trace data is sent to the console.
This constant is not available.
trCreation Clears the trace file.
trDisable All the calls to Trace will be ignored.
trFile The trace window will not be displayed anymore and the information found in the trace window will be saved in the file named <Trace file>.
Only this constant is available. By default, this file is created in the UNIX temporary directory with the name "Trace_<Project>.txt".

In AWPmode, only this constant is available.
trTopMost The trace window will be displayed above all system windows.
This constant is not available.
trWindow
(Default value) The trace window is displayed in the upper-left corner of the screen.

When deploying a site, the trace window is not displayed.

The trace is displayed in the current page.
trWindow + trFile The trace window will be displayed and the content of the trace window will also be saved in the file named <Trace file>.
The trace is displayed in the current page and in a file.
This parameter is not available.

Remarks

Use conditions according to the platforms

TraceStart is used to save the requested information in a file. By default, this file is created in the UNIX temporary directory with the name "Trace_<Project>.txt".

TraceStart is used to display the requested information in the current page or to store it in a file.

In AWP mode, TraceStart can only be used to save the requested information in a file.

Closing the trace window

TraceEnd is used to close the trace window.

If the trFile constant is specified, TraceEnd stops saving to the trace file.

Trace window

The trace window displayed from a Browser code is different from the one displayed from a Server code. Therefore, two different trace windows can be opened at the same time.

Component: wd300vm.dll