TraceStart (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Windows management functions

Miscellaneous WINDEV functions

TraceStart

Presentation

Example

Use conditions according to the platforms

Closing the trace window

BuildAutomationVariant

Calling a DLL written in Visual Basic

Constants for managing the WLanguage types

Constants for sound management

Constants used by ExecutePresetAction

Constants used by the TraceStart function

EndAutomatedProcedure

InAndroidEmulatorMode

InAndroidMode

InAndroidSimulatorMode

InAppleWatchEmulatorMode

InAppleWatchMode

InAppleWatchSimulatorMode

InAutomaticTestMode

InBackgroundMode

InComponentMode

InDelayedProcedureMode

InPocketSimulatorMode

InPrelaunchedSessionMode

InReportsAndQueriesMode

InServiceMode

InSimulatorMode

InStoredProcedureMode

InSysNotificationMode

InTSEMode

InTestMode

InUMCMode

InUniversalWindowsAppMode

InUniversalWindowsAppSimulatorMode

InUniversalWindowsPlatformMode

InUniversalWindowsPlatformSimulatorMode

InVGAMode

InWebMode

InWebSocketServerGlobalServiceMode

InWebSocketServerMode

InWindowsPhoneEmulatorMode

InWindowsPhoneMode

InWindowsPhoneSimulatorMode

InWindowsStoreAppMode

InWindowsStoreAppSimulatorMode

OpenDocumentAsynchronous

StyleDrawCaptionGrayed

Voice commands in your applications

WHelp

WINDEVVersion

WLanguage procedure called by OpenDocumentAsynchronous

diffApply

diffCreate

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 is replaced by 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.

Versions 17 and later

This function is now available for iPhone/iPad applications.

This function is now available for Android applications.

New in version 17

This function is now available for iPhone/iPad applications.

This function is now available for Android applications.

This function is now available for iPhone/iPad applications.

This function is now available for Android applications.

Versions 18 and later

This function is now available in Android widget mode.

This function is now available in Windows Store apps mode.

New in version 18

This function is now available in Android widget mode.

This function is now available in Windows Store apps mode.

This function is now available in Android widget mode.

This function is now available in Windows Store apps mode.

Versions 21 and later

This function is now available in Apple Watch mode.

This function is now available in Universal Windows 10 App mode.

New in version 21

This function is now available in Apple Watch mode.

This function is now available in Universal Windows 10 App mode.

This function is now available in Apple Watch mode.

This function is now available in Universal Windows 10 App mode.

Example

// Opens the trace window
TraceStart()
...
// Writes into the trace window
Trace("Calculation result: " + ResCalc)

// Disable the calls to the Trace function
TraceStart(trDisable)
...
Trace("Calculation result: " + ResCalc) // Trace has no effect

// 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:
trCreation Clears the trace file.
trTopMost The trace window will be displayed above all the system windows.
This constant is not available.
trDisable All the calls to Trace will be ignored.
trWindow
(Default value) The trace window is displayed in the top left corner of the screen.
The trace window will not be displayed when a site is deployed.

The trace window will not be displayed when starting the application.
the requested information will be displayed in the window for standard output of Xcode.
the requested information will be stored in the application log (at runtime 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.

The trace is displayed in the current page.
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 and is named "Trace_<Project>.txt".

In AWP mode, only this constant is available.
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.

<Trace file>: Optional character string

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".
If this parameter is not specified, the trace file will be created in the temporary UNIX directory as "Trace_<ProjectName>.txt".
This parameter is not available.
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".

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".

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

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".

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.

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.

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 saving to the trace file.

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: wd270vm.dll