ATLTraceTool, exemple : affiche les résultats de ATLTRACE2

Mise à jour : novembre 2007

L'exemple ATLTraceTool génère une application qui spécifie quels messages ATLTRACE2 s'affichent dans la fenêtre Sortie. Cette application, ATL Trace Tool, affiche des messages de trace du débogage dans les sources ATL et MFC. Vous pouvez contrôler le type et le volume des messages affichés.

AtlTraceTool.exe est fourni avec Visual Studio et se trouve dans le répertoire \Program Files\Microsoft Visual Studio 9.0\Common7\Tools. AtlTraceTool.exe est aussi disponible à partir du menu Outils de l'environnement de développement.

Note de sécurité :
Cet exemple de code est fourni pour illustrer un concept et ne doit pas être utilisé dans des applications ou des sites Web, car il peut ne pas illustrer les pratiques de programmation les plus sûres. Microsoft n'assume aucune responsabilité pour tout dommage indirect ou consécutif en cas d'utilisation de l'exemple de code à des fins autres que celles prévues.

Pour obtenir des exemples et des instructions d'installation :

• Dans le menu ? (Aide) de Visual Studio, cliquez sur Exemples.

  Pour plus d'informations, consultez Recherche des fichiers d'exemple.

• La liste la plus récente et la plus complète d'exemples est disponible en ligne à partir de la page Visual Studio 2008 Samples.

• Des exemples sont également disponibles sur le disque dur de votre ordinateur. Des exemples et un fichier Readme sont copiés par défaut dans un dossier sous \Program Files\Visual Studio 9.0\Samples\. Pour les éditions Express de Visual Studio, tous les exemples sont accessibles en ligne.

Génération et exécution de l'exemple

Pour générer et exécuter cet exemple

1. Ouvrez le fichier solution tracetool.sln.

2. Dans le menu Générer, cliquez sur Générer.

3. Dans le menu Déboguer, cliquez sur Exécuter sans débogage.

Remarque :
Cette procédure est facultative. Vous pouvez utiliser l'utilitaire prégénéré AtlTraceTool.exe si vous le souhaitez.

Pour utiliser ATLTraceTool.exe

1. Déboguez un projet MFC ou ATL en cliquant dans le menu Déboguer sur Démarrer.

2. Dans le menu Outils, cliquez sur MFC/ATL Trace Tool si cet outil n'est pas déjà en cours d'exécution.

3. Développez la liste de contrôles d'arborescence dans la fenêtre Liste des traces. La fenêtre affiche l'application en cours d'exécution, les modules qu'elle comprend éventuellement et les catégories de traces pour chaque module.

4. Pour chaque processus, module et catégorie, personnalisez les informations qui s'affichent dans la fenêtre Sortie. Le contrôle Niveau de trace du groupe Process se rapporte au niveau ATLTRACE2 ; seuls les messages ATLTRACE2 dont le niveau est supérieur ou égal à la valeur du contrôle Niveau de trace s'affichent dans la fenêtre Sortie.

5. Cliquez sur Appliquer pour que les paramètres prennent effet.

Vous pouvez enregistrer vos paramètres et les charger lors du débogage suivant de l'application ; pour ce faire, utilisez les boutons Enregistrer et Charger.

Interface utilisateur de ATL Trace Tool

• Trace List
  Contrôle d'arborescence contenant une liste des processus qui utilisent les sources de débogage ATL/MFC. Chaque processus contient la liste des modules qui, à leur tour, contiennent les catégories de traces.

• Actualiser
  Met à jour la liste des processus et des modules situés sous Trace List.

• Process
  Paramètres au niveau du processus :

  Niveau de trace – Équivaut au paramètre au niveau de la trace des appels passés à ATLTRACE2. Actuellement, les sources ATL/MFC utilisent un niveau de trace de 0 à 4, 0 correspondant au niveau le plus critique.

  Enabled – Active le traçage pour le processus.

  Category & Function Names – Inclut la catégorie de la trace et le nom de la fonction dans les messages de trace.

  Nom du fichier et n° de ligne. - Inclut le nom de fichier et le numéro de ligne dans les messages de trace.

• Module
  Vous devez d'abord sélectionner un module dans le contrôle d'arborescence Trace List avant d'activer ce groupe. Ces paramètres affectent le module.

  Niveau de trace – Équivaut au paramètre au niveau de la trace des appels passés à ATLTRACE2. Actuellement, les sources ATL/MFC utilisent un niveau de suivi de 0 à 4, 0 correspondant au niveau le plus critique.

  Inherit from Process – Permet l'utilisation des paramètres de trace du groupe Processus pour ce module.

  Enabled – Active le traçage pour ce module.

  Disabled – Désactive le traçage pour ce module.

• Category
  Vous devez d'abord sélectionner une catégorie dans le contrôle d'arborescence Trace List avant d'activer ce groupe. Ces paramètres affectent la catégorie à l'intérieur du module.

  Niveau de trace – Équivaut au paramètre au niveau de la trace des appels passés à ATLTRACE2. Actuellement, les sources ATL/MFC utilisent un niveau de suivi de 0 à 4, 0 correspondant au niveau le plus critique.

  Inherit from Module – Permet l'utilisation des paramètres de trace du groupe Module pour cette catégorie.

  Enabled – Active le traçage pour cette catégorie.

  Disabled – Désactive le traçage pour cette catégorie.

• Enregistrer
  Enregistre les paramètres du processus actuel et tous les modules qu'il contient dans un fichier .trc. Il est possible de charger ce fichier en utilisant le bouton Charger ou en appelant AtlTraceLoadSettings à partir du projet. Si le fichier .trc se trouve dans le même répertoire que celui des EXE/DLL, vous pouvez appeler AtlTraceLoadSettings et passer une valeur NULL pour le nom du fichier.

• Charger
  Charge un fichier .trc.

• Appliquer
  Applique les paramètres actuels au processus chargé.

• Fermer
  Ferme la boîte de dialogue ATL/MFC Trace Tool. Les modifications ne sont pas prises en compte tant que vous n'avez pas cliqué sur le bouton Appliquer.

• Aide
  Affiche l'aide.

Voir aussi

Autres ressources

Exemples ATL