Образец ATLTraceTool: отображение выходных данных образца ATLTRACE2

Обновлен: Ноябрь 2007

В образце ATLTraceTool выполняется построение приложения, которое указывает, какие сообщения ATLTRACE2 выводятся в окне выходных данных. Это приложение (инструмент трассировки ATL) выводит сообщения трассировки отладки в источниках ATL и MFC. Можно управлять типом и количеством отображаемых сообщений.

Файл AtlTraceTool.exe входит в состав Visual Studio и находится в каталоге \Program Files\Microsoft Visual Studio 9.0\Common7\Tools. Программа AtlTraceTool.exe также доступна из меню Сервис в среде разработки.

Примечание о безопасности.
Этот образец кода служит для демонстрации основных принципов и не предназначен для использования в приложениях или на веб-узлах, поскольку не может считаться примером наиболее безопасного кода. Корпорация Майкрософт не несет ответственности за случайные или косвенные убытки в случае использования образца кода не по назначению.

Чтобы получить образцы и инструкции по их установке, выполните следующие действия.

• В меню Справка среды Visual Studio выберите пункт Примеры.

  Дополнительные сведения см. в разделе Поиск файлов примеров.

• Самая последняя версия и полный список образцов доступны в Интернете на странице образцов Visual Studio 2008.

• Кроме того, образцы находятся на жестком диске компьютера. По умолчанию образцы кода и файл Readme копируются в папку, находящуюся в папке \Program Files\Visual Studio 9.0\Samples\. Все образцы кода для экспресс-выпусков Visual Studio находятся в Интернете.

Построение и запуск образца

Построение и запуск этого образца

1. Откройте файл решения tracetool.sln.

2. В меню Построение выберите команду Построить.

3. В меню Отладка выберите команду Запуск без отладки.

Примечание.
Эта процедура является необязательной. Вместо нее можно использовать готовый файл AtlTraceTool.exe.

Использование ATLTraceTool.exe

1. Выполните отладку проекта MFC или ATL, выбрав команду Пуск из меню Debug.

2. В меню Сервис выберите пункт Программа трассировки MFC/ATL, если она еще не запущена.

3. Разверните иерархический список в окне Список трассировки. В окне показано выполняющееся приложение, все модули, расположенные в этом приложении, и категории трассировки для каждого модуля.

4. Укажите для каждого процесса, модуля и категории, какие сведения будут отображаться в окне выходных данных. Элемент управления Уровень трассировки в группе Процесс связан с уровнем ATLTRACE2. В окне выходных данных будут отображаться только сообщения ATLTRACE2 с уровнем, который больше или равен значению в элементе управления Уровень трассировки.

5. Чтобы изменения вступили в силу, нажмите кнопку Применить.

Можно сохранить параметры и загрузить их во время следующей отладки приложения. Для этого предназначены кнопки Сохранить и Загрузить.

Пользовательский интерфейс инструмента трассировки ATL

• Список трассировки
  Элемент управления иерархического представления со списком процессов, которые используют отладочный исходный код ATL и MFC. Под каждым процессом приведены модули, а под каждым модулем показаны категории трассировки.

• Обновить
  Обновляет список процессов и модулей в иерархии Список трассировки.

• Группа процессов
  Параметры уровня процесса:

  Уровень трассировки. Соответствует параметру уровня трассировки при вызовах ATLTRACE2. В текущей версии источники ATL и MFC используют уровень трассировки 0–4, где 0 является уровнем максимальной важности.

  Включено. Включает трассировку для процесса.

  Имена категорий и функций. Включает в сообщения трассировки категорию трассировки и имя функции.

  Имя файла и номер строки. Включает имя файла и номер строки в сообщения трассировки.

• Группа модулей
  Перед тем, как эта группа станет доступной, нужно выбрать модуль в элементе управления иерархического представления Список трассировки. Эти параметры действуют на модуль.

  Уровень трассировки. Соответствует параметру уровня трассировки при вызовах ATLTRACE2. В текущей версии источники ATL и MFC используют уровень трассировки 0–4, где 0 является уровнем максимальной важности.

  Наследование из процесса. Позволяет использовать для данного модуля параметры трассировки из группы Процесс.

  Включено. Включает трассировку для этого модуля.

  Отключено. Отключает трассировку для этого модуля.

• Группа категорий
  Перед тем, как эта группа станет доступной, нужно выбрать категорию в элементе управления иерархического представления Список трассировки. Эти параметры действуют на категорию в пределах модуля.

  Уровень трассировки. Соответствует параметру уровня трассировки при вызовах ATLTRACE2. В текущей версии источники ATL и MFC используют уровень трассировки 0–4, где 0 является уровнем максимальной важности.

  Наследование из модуля. Позволяет использовать для данной категории параметры трассировки из группы Module.

  Включено. Включает трассировку для этой категории.

  Отключено. Отключает трассировку для этой категории.

• Сохранить
  Сохраняет параметры для текущего процесса и всех его модулей в TRC-файл. TRC-файл можно загрузить с помощью кнопки Загрузить или путем вызова AtlTraceLoadSettings из проекта. Если TRC-файл находится в одном каталоге с EXE-файлом или DLL-файлом, можно вызвать AtlTraceLoadSettings и передать значение NULL в качестве имени файла.

• Загрузить
  Загружает TRC-файл.

• Применить
  Применяет текущие параметры к загруженному процессу.

• Закрыть
  Закрывает диалоговое окно Программа трассировки ATL/MFC. Изменения не вступят в силу, если не была нажата кнопка Применить.

• Справка
  Выводит справку.

См. также

Другие ресурсы

Образцы ATL