PC SOFT

ONLINE HELP
FOR WINDEV, WEBDEV AND WINDEV MOBILE

Home | Sign in | English US
  • Use conditions according to the platforms
  • Closing the trace window
  • Trace window
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Others
Stored procedures
Warning
From version 17 (78), StartTrace is kept for backward compatibility. This function is replaced by TraceStart.
Opens the trace window or saves the trace information in a text file.
Notes:
  • TraceStart has no effect if the trace window is already opened.
  • TraceStart is optional. The first call to Trace automatically opens the trace window.TraceStart is optional. The first call to Trace or to TraceBuild automatically opens the trace window.
Versions 17 and later
iPhone/iPad This function is now available for the iPhone/iPad applications.
Android This function is now available for the Android applications.
New in version 17
iPhone/iPad This function is now available for the iPhone/iPad applications.
Android This function is now available for the Android applications.
iPhone/iPad This function is now available for the iPhone/iPad applications.
Android This function is now available for the Android applications.
Versions 18 and later
Android Widget This function is now available in Android Widget mode.
Universal Windows 10 App This function is now available in Windows Store apps mode.
New in version 18
Android Widget This function is now available in Android Widget mode.
Universal Windows 10 App This function is now available in Windows Store apps mode.
Android Widget This function is now available in Android Widget mode.
Universal Windows 10 App This function is now available in Windows Store apps mode.
Versions 21 and later
Apple Watch This function is now available in Apple Watch mode.
Universal Windows 10 App This function is now available in Universal Windows 10 App mode.
New in version 21
Apple Watch This function is now available in Apple Watch mode.
Universal Windows 10 App This function is now available in Universal Windows 10 App mode.
Apple Watch This function is now available in Apple Watch mode.
Universal Windows 10 App This function is now available in Universal Windows 10 App mode.
Example
WINDEVWEBDEV - Server codeWEBDEV - Browser codeReports and QueriesiPhone/iPadApple WatchWindows MobileUniversal Windows 10 AppJavaAjaxUser code (UMC)
// Opens the trace window
TraceStart()
...
// Writes into the trace window
Trace("Calculation result: " + ResCalc)
WINDEVWEBDEV - Server codeReports and QueriesiPhone/iPadApple WatchWindows MobileUniversal Windows 10 AppJavaAjaxUser code (UMC)
// Disable the calls to the Trace function
TraceStart(trDisable)
...
Trace("Calculation result: " + ResCalc)  // Trace has no effect
WINDEVWEBDEV - Server codeReports and QueriesAjaxUser code (UMC)
// Save the information found in
// the trace window in the "C:\Trace\MyFile.txt" file
TraceStart(trFile, "C:\Trace\MyFile.txt")
...
Trace("Calculation result: " + ResCalc)
// No trace window is displayed
// This information will be saved in the "C:\Trace\MyFile.txt" file
Syntax
TraceStart([<Characteristic> [, <Trace file>]])
<Characteristic>: Optional constant
Characteristics of trace:
trCreationClears the trace file.
trTopMostThe trace window will be displayed above all the system windows.
AndroidAndroid Widget iPhone/iPadApple WatchJavaJavaPHP This constant is not available.
trDisableAll the calls to Trace will be ignored.
trWindow
(Default value)		The trace window is displayed in the top left corner of the screen.
WEBDEV - Server code The trace window will not be displayed when a site is deployed.

AndroidAndroid Widget iPhone/iPadApple WatchWindows Mobile The trace window will not be displayed when starting the application.
  • iPhone/iPadApple Watch the requested information will be displayed in the window for standard output of Xcode.
  • AndroidAndroid Widget the requested information will be stored in the application log (at run time or in emulation mode). This log can be viewed when the device is connected via USB or when using the emulator from the DDMS application supplied with the Android SDK.

PHP The trace is displayed in the current page.
trFileThe trace window will not be displayed anymore and the information found in the trace window will be saved in the file named <Trace File>.
Linux Only this constant is available. By default, this file is created in the UNIX temporary directory and is named "Trace_<Project>.txt".

WEBDEV - Server code In AWP mode, only this constant is available.
trWindow + trFileThe trace window will be displayed and the content of the trace window will also be saved in the file named <Trace File>.
PHP The trace is displayed in the current page and in a file.
WEBDEV - Browser code This parameter is not available.
<Trace file>: Optional character string (with quotes)
Name and full path of the file where the information found in the trace window will be saved. If this parameter is not specified, the trace file will be created at the root of the "C" drive and its name will have the following format "Trace_<ProjectName>.txt".
Windows Mobile If this parameter is not specified, the trace file will be created at the root of the disk and its name will follow the format "Trace_<ProjectName>.txt".
Linux If this parameter is not specified, the trace file will be created in the temporary UNIX directory as "Trace_<ProjectName>.txt".
WEBDEV - Browser code This parameter is not available.
AndroidAndroid Widget Java If this parameter is not specified, the file is created in the current directory of the application (known via fCurrentDir) under the name, "Trace_<ProjectName>.txt".
Universal Windows 10 App If this parameter is not specified, the file is created in the data directory of the application (returned by fDataDir) and it is named "Trace_<ProjectName>.txt".
iPhone/iPadApple Watch If this parameter is not specified, the file is created in the "documents" directory of the application and it is named "Trace_<ProjectName>.txt".
Remarks

Use conditions according to the platforms

Linux TraceStart is used to save the requested information in a file. By default, this file is created in the UNIX temporary directory and is named "Trace_<Project>.txt".
PHP TraceStart is used to display the requested information in the current page or to store it in a file.
WEBDEV - Server code In AWP mode, TraceStart can only be used to save the requested information in a file.
AndroidAndroid Widget TraceStart is used to save the requested information:
  • in the application log (at runtime or in emulator mode). This log can be viewed when the device is connected via USB or when using the emulator from the DDMS application supplied with the Android SDK.
  • in a specific text file.
iPhone/iPadApple Watch TraceStart is used to:
  • display the requested information in the window for standard output of Xcode.
  • save the requested information in a specific text file.

Closing the trace window

TraceEnd is used to close the trace window.
If the trFile constant is specified, TraceEnd stops the backup in the trace file.
WEBDEV - Server codeWEBDEV - Browser codeAjax

Trace window

The trace window displayed from a browser code differs from the trace window displayed from a server code. Therefore, two different trace windows can be opened at the same time.
Component : wd240vm.dll
See also
Minimum required version
  • Version 9
This page is also available for…
Comments
Video Trace
https://youtu.be/scI5wQu-jXk
//
fDelete("C:\TEMP\ARQUIVO.TXT") // ELIMINA ARQUIVOS CASO JA EXISTA
TraceStart(trFile+trWindow,"C:\TEMP\ARQUIVO.TXT")
FOR EACH cliente // ESTOU PERCORRENDO A TABELA CLIENTE // I AM PERCURRING THE CLIENT TABLE // Je passe à la table des clients
Trace(cliente.id_cliente+"|"+cliente.razao_social_nome+"|")
END
TraceEnd() // FINALIZANDO O TRACE // FINISHING THE TRACE // FINITION DE LA TRACE
ShellExecute("C:\TEMP\ARQUIVO.TXT")
amarildo
Dec. 30 2018