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

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.

Notes:

Trace 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.
trace window displays in both development and execution modes. To avoid a runtime display, use function InTestMode.

Example

// ------------------
// 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)
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 and is named "Trace_<Project>.txt".

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.
Trace is similar to Info but the information is displayed in another window and no key needs to be pressed.

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.
Caution: This option is available only if the wdxxxstd.dll library is on the end-user computer.
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 special characters in gray or use them directly: EOT, TAB, etc. Therefore, the "Carriage Return" (CR) characters in the trace window are represented as "<\r><\n>".
Remark: This option will be taken into account from the next line of information displayed.

Component: wd290vm.dll