Trace (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
Trace window
Context menu of the trace window
Special case

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

Trace (Function)

In french: Trace

Displays the requested information (content of a control, for example) in a window opened next to the current window.

Remarks:

is useful during the development process to check whether a program runs properly. In the editor, the "Debugger trace" displays the information found in the trace window as well as the full text of errors that occurred.
The trace window is displayed in both development and run mode. To avoid a runtime display, use the InTestMode function.

Example

// ------------------
// Affichage d'informations dans la fenêtre de trace 
Trace("Résultat du calcul : " + ResCalcul)
// ----------------

// Surcharge de l'affichage de la trace
PROCEDURE Trace(MessageAAfficher)
IF InTestMode() THEN Trace(MessageAAfficher)

// Appel de la fonction Trace surchargée
WL.Trace("Lancement de la trace")

Syntax

Trace(<Information> [, <Additional information 1> [... [, <Additional information N>]]])

<Information>: Any type

Set of elements that will be displayed in the trace window.

<Additional information 1>: Any type (optional)

Additional information to be displayed in the trace window. It will be displayed on the same line as <Information>.

<Additional information N>: Any type (optional)

Additional information to be displayed in the trace window. It will be displayed on the same line as <Information>.

Remarks

Use conditions according to the platforms

Trace can be used to display the requested information in a file only. By default, this file is created in the UNIX temporary directory with the name "Trace_<Project>.txt".

The information of Trace is displayed at the beginning of the HTML page returned.

For WEBDEV pages:

The trace window is displayed in test mode ("Go" option) only for dynamic pages (other than Active WEBDEV Pages).
In AWP and deployment mode, Trace can only be used to write the specified information to a file (trFile constant used with TraceStart).

Trace window

The information passed as parameter is displayed on the next line of the trace window.
The trace window opens automatically the first time Trace is called (TraceStart is executed automatically). By default, this window is opened in the upper-left corner of the screen. It can be moved. The new position is automatically saved.
Trace is similar to Info but the information is displayed in another window and no key needs to be pressed.
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.

Context menu of the trace window

The context menu of the trace window allows you to:

copy/cut/paste the content of trace window.
save the content of the trace window in a text file.
Note: This option is only available if the wdxxxstd.dll library is present on the end-user workstation.
clear the contents of the trace window.
open the trace window on top of all the other windows (including the windows from the other applications).
save the size and position of the trace window when it is closed. When this window is displayed again, it will keep the size and position saved.
display a horizontal scrollbar.
Display control characters: Special characters will be displayed in grayed and literal form: EOT, TAB, etc. Therefore, the "Carriage Return" (CR) characters in the trace window are represented as "<\r><\n>".
Note: This option will only be taken into account from the next line of information displayed.

Special case

PageDisplay and PageRefresh cannot be used after Trace.

If PageDisplay and PageRefresh are used, a warning message will be displayed by the PHP engine.

Component: wd300vm.dll