PC SOFT

ONLINE HELP
FOR WINDEV, WEBDEV AND WINDEV MOBILE

Home | Sign in | English US

  • Using TraceBuild in the multilingual applications
  • Use conditions according to the platforms
  • Trace window
  • Popup menu of trace window
  • Special case
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
Displays a customizable message in the trace window opened in parallel of the current window.
Note: Like Trace, TraceBuild is useful during the development to check whether a program is operating properly. In the editor, the "Trace of debugger" pane displays the information found in the trace window as well as the full text of errors that occurred.
Versions 22 and later
Android Widget This function is now available in Android Widget mode.
Android This function is now available for the Android applications.
WINDEVJava This function is now available for the Java applications.
WEBDEV - Server codePHP This function is now available for the PHP sites.
New in version 22
Android Widget This function is now available in Android Widget mode.
Android This function is now available for the Android applications.
WINDEVJava This function is now available for the Java applications.
WEBDEV - Server codePHP This function is now available for the PHP sites.
Android Widget This function is now available in Android Widget mode.
Android This function is now available for the Android applications.
WINDEVJava This function is now available for the Java applications.
WEBDEV - Server codePHP This function is now available for the PHP sites.
Example
// Display an error message in the trace window
TraceBuild("The customer code %1 does not exist.", nCustomerCode)
Syntax
TraceBuild(<Initial String> [, <Parameter 1> [, ... [, <Parameter N>]]])
<Initial String>: Character string
Character string to display. This string contains optional parameters (%1 to %n). To display the % character, this character must be typed twice (%%).
<Parameter 1>: Optional character string (with quotes)
First parameter that will be inserted into the formatted character string.
<Parameter 1> will replace the %1 character, <Parameter 2> will replace the %2 character, etc.
The number of specified parameters must be equal to or greater than the number of parameters used in <Initial String>.
If <Initial String> contains more parameters, the additional parameters will be replaced by empty strings.
<Parameter N>: Optional character string (with quotes)
Nth parameter that will be inserted into the formatted character string.
<Parameter 1> will replace the %1 character, <Parameter 2> will replace the %2 character, etc.
The number of specified parameters must be equal to or greater than the number of parameters used in <Initial String>.
If <Initial String> contains more parameters, the additional parameters will be replaced by empty strings.
Remarks

Using TraceBuild in the multilingual applications

In a multilingual application, using TraceBuild simplifies the translation:
  • the translator translates the message by positioning the characters "%1", "%2", ... at the relevant location according to the language.
  • the optional characters can be replaced in all the supported languages.

Use conditions according to the platforms

Windows Mobile TraceBuild is taken into account during a test in the simulator and during a test on the Pocket PC. In this last case, the information is directly displayed in the environment, in the "Trace of debugger" pane.
Linux TraceBuild 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".
Versions 22 and later
PHP The information of TraceBuild is displayed at the beginning of the HTML page returned.
AndroidAndroid Widget TraceBuild is used to save the requested information in the application log (at run time 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.
New in version 22
PHP The information of TraceBuild is displayed at the beginning of the HTML page returned.
AndroidAndroid Widget TraceBuild is used to save the requested information in the application log (at run time 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.
PHP The information of TraceBuild is displayed at the beginning of the HTML page returned.
AndroidAndroid Widget TraceBuild is used to save the requested information in the application log (at run time 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.
WEBDEV - Server code In AWP mode, TraceBuild is used to display the requested information in a file only (trFile constant used with TraceStart).
iPhone/iPadApple Watch TraceBuild displays the requested information in the standard output window of Xcode.
WINDEVWEBDEV - Server codeWEBDEV - Browser codeWindows Mobile

Trace window

  • The trace window is automatically opened during the first call to TraceBuild (TraceStart is automatically run). By default, this window is opened in the top left corner of the screen.
  • The operating mode of TraceBuild is equivalent to the operating mode of InfoBuild but the display is performed in a parallel window, without waiting for keys.
  • WEBDEV - Server codeWEBDEV - Browser code 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.
WINDEVWEBDEV - Server codeWEBDEV - Browser codeWindows Mobile

Popup menu of trace window

The popup menu of Trace window is used to:
  • copy/cut/paste the content of the 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 found on the end-user computer.
  • clear the content of the trace window.
  • open the trace window on top of all the other windows (including the windows from the other applications).
  • store the size and position of the trace window when it is closed. When re-displaying this window, it will be displayed according to the size and position stored.
  • display an horizontal scrollbar.
  • display special characters in gray and literally: EOT, TAB, etc. Therefore, the "Carriage Return" (CR) characters found correspond to "<\r><\n>".
    Note: This option will be taken into account from the next line of information displayed.
WEBDEV - Server code

Special case

PageDisplay and PageRefresh cannot be used after TraceBuild.
Versions 22 and later
PHP If PageDisplay and PageRefresh are used, a warning message will be displayed by the PHP engine.
New in version 22
PHP If PageDisplay and PageRefresh are used, a warning message will be displayed by the PHP engine.
PHP If PageDisplay and PageRefresh are used, a warning message will be displayed by the PHP engine.
Components
WINDEVWEBDEV - Server codeReports and Queries wd230vm.dll
Windows Mobile wp230vm.dll
Java wd230java.jar
Linux wd230vm.so
Android wd230android.jar
Minimum required version
  • Version 21
This page is also available for…
Comments
Click [Add] to post a comment