ATLTraceTool 示例：显示 ATLTRACE2 的输出
更新：2007 年 11 月
ATLTraceTool 示例生成一个应用程序，该应用程序指定在输出窗口中显示哪些 ATLTRACE2 消息。该应用程序（ATL 跟踪工具）显示 ATL 和 MFC 源中的调试跟踪消息。您可以控制所显示消息的类型和数量。
Visual Studio 附带了 AtlTraceTool.exe，此文件可在 \Program Files\Microsoft Visual Studio 9.0\Common7\Tools 目录中找到。AtlTraceTool.exe 也可以通过开发环境的“工具”菜单使用。
.gif "安全说明") 安全说明： |
|---|
提供该示例代码是为了阐释一个概念，并不代表着最安全的编码实践，因此不应在应用程序或网站中使用该示例代码。对于超出本示例代码的预期用途以外的使用所造成的偶然或继发性损失，Microsoft 不承担任何责任。 |
获取示例和安装示例的说明：
在 Visual Studio 的“帮助”菜单上，单击“示例”。
有关更多信息，请参见定位示例文件。
示例的最新版本和完整列表可以从 Visual Studio 2008 Samples page（Visual Studio 2008 示例页面）联机获取。
还可以在计算机的硬盘上查找示例。默认情况下，示例和自述文件将复制到 \Program Files\Visual Studio 9.0\Samples\ 下的文件夹中。对于 Visual Studio 速成版，所有示例都位于联机位置。
生成并运行示例
生成并运行此示例
打开解决方案文件 tracetool.sln。
从“生成”菜单中，单击“生成”。
在“调试”菜单中，单击“开始执行（不调试）”。
.gif "说明") 说明： |
|---|
此过程是可选的。如果愿意，您可以改用预生成的 AtlTraceTool.exe。 |
使用 ATLTraceTool.exe
通过单击“调试”菜单中的“启动”来调试 MFC 项目或 ATL 项目。
从**“工具”菜单中单击“ATL/MFC 跟踪工具”**（如果它尚未运行）。
展开**“跟踪列表”**窗口中的树控件列表。该窗口显示正在运行的应用程序、该应用程序中的所有模块以及每个模块的跟踪类别。
对于每个进程、模块和类别，自定义在输出窗口中显示的信息。**“进程”组中的“跟踪级别”控件与 ATLTRACE2 级别相关；只有级别等于或大于“跟踪级别”**控件中的设置的 ATLTRACE2 消息才会显示在输出窗口中。
单击**“应用”**使设置生效。
可以使用“保存”和**“加载”**按钮保存您的设置并在下次调试应用程序时加载它们。
ATL 跟踪工具用户界面
跟踪列表
一个包含使用调试 ATL/MFC 源的进程列表的树控件。在每个进程下列出了模块，在每个模块下列出了跟踪类别。刷新
更新**“跟踪列表”**下的进程和模块列表。进程组
进程宽度设置：跟踪级别 — 等同于对 ATLTRACE2 的调用中的跟踪级别参数。目前，ATL/MFC 源使用的跟踪级别分为 0–4 级，其中 0 是最关键的级别。
启用 — 启用进程跟踪。
类别和函数名 — 在跟踪消息中包含跟踪类别和函数名。
文件名和行号 — 在跟踪消息中包含文件名和行号。
模块组
必须首先在**“跟踪列表”**树控件中选择模块，然后才能启用此组。这些设置将影响模块。跟踪级别 — 等同于对 ATLTRACE2 的调用中的跟踪级别参数。目前，ATL/MFC 源使用的跟踪级别分为 0-4 级，其中 0 级是最关键的级别。
从进程继承 — 使**“进程”**组中的跟踪设置也能用于此模块。
启用 — 对此模块启用跟踪。
禁用 — 对此模块禁用跟踪。
类别组
必须首先在“跟踪列表”树控件中选择类别，然后才能启用此组。 这些设置将影响模块内的类别。跟踪级别 — 等同于对 ATLTRACE2 的调用中的跟踪级别参数。目前，ATL/MFC 源使用的跟踪级别分为 0-4 级，其中 0 级是最关键的级别。
从模块继承 — 使 Module 组中的跟踪设置也能用于此类别。
启用 — 对此类别启用跟踪。
禁用 — 对此类别禁用跟踪。
保存
将当前进程的设置及该进程下的所有模块保存到 .trc 文件。通过使用**“加载”**按钮或从项目中调用 AtlTraceLoadSettings 可加载 .trc 文件。如果 .trc 文件与 EXE/DLL 位于同一目录下，您可以调用 AtlTraceLoadSettings 并为文件名传递 NULL。加载
加载 .trc 文件。应用
将当前设置应用到加载的进程。关闭
关闭**“ATL/MFC 跟踪工具”对话框。除非选择了“应用”**，否则更改不会生效。帮助
显示帮助。