Event Log Options

From RAD Studio
Jump to: navigation, search

Go Up to Debugger Options


Tools > Options > Debugger > Event Log

Use this dialog box to control the content, size, and appearance of the event log.

General

Item Description

Clear log on run

Causes the event log to be purged at the start of each debug session. If this option is checked while debugging multiple processes, the event log view is cleared when the very first process is started. However, any process started while at least one process is already being debugged will not cause the event log view to be cleared.

Unlimited length

Removes the limit on the length of the event log. When this option is unchecked, set the maximum length of the event log in the Length field.

Length

Displays the maximum length of the event log. If the Unlimited length check box is checked, this option is inactive. For multiple process debugging, length is the total for the event log, not for a process. The default length is 100.

Scroll new events into view

Controls scrolling of the event log. When this option is set, the event log scrolls in order to display new events as they occur. You can stop the scrolling of the event log by clicking the log area. To resume scrolling, press END or click the last displayed event. Disable this option to prevent the event log from scrolling. (Set by default.)

Display process info with event

Shows the process name and process ID for the process that generated each event.

Messages

Item Description

Breakpoint Messages

Writes a message to the event log each time a breakpoint or First-chance exception is encountered. The message includes the current EIP address of the program being debugged in addition to information about the breakpoint (pass count, condition, source file name, and line number) or exception. (Set by default.)

Process Messages

Writes a message to the event log each time a process loads or terminates, whenever a module is loaded or unloaded by the process. (Set by default.)

Thread Messages

Writes a message to the event log each time a thread is created or destroyed during a debugging session. (Set by default.)

Module Messages

Writes a message to the event log each time a module (executable, shared object, or package) is loaded or unloaded. It includes the name of the module, its base address, and whether it has debug information. (Set by default.)

Output Messages

Writes a message to the event log each time your program or one of its modules calls OutputDebugString. (Set by default.)This setting is used only by the Win32 Debugger.

Windows Messages

Writes a message to the event log for each window message that is sent or posted to one of the windows of your application. The log entry will have details about the message, including the message name and any relevant data encoded in its parameters. Messages are not immediately written to the log if your process is running and not stopped in the debugger. As soon as you pause the process in the debugger (by encountering a breakpoint or using Run| Pause) the messages will be written to the event log. (Off by default)This setting is used only by the Win32 Debugger.

Colors

Item Description

Use Event Log Colors

Associates colors with specific message types so that the message is displayed in that color in the event log.

Foreground

Sets the color for text that appears in the event log.

Background

Sets the color for the background of the event log.