Esempio ATLTraceTool: visualizzazione dell'output di ATLTRACE2
Aggiornamento: novembre 2007
Nell'esempio ATLTraceTool viene generata un'applicazione che consente di specificare i messaggi di ATLTRACE2 che verranno visualizzati nella finestra di output. Questa applicazione, corrispondente allo strumento di analisi ATL, consente di visualizzare messaggi di analisi di debug nelle origini ATL e MFC. È possibile controllare il tipo e il numero dei messaggi visualizzati.
AtlTraceTool.exe, fornito con Visual Studio, è disponibile nella directory \Programmi\Microsoft Visual Studio 9.0\Common7\Tools. AtlTraceTool.exe è inoltre accessibile dal menu Strumenti nell'ambiente di sviluppo.
.gif "Nota sulla sicurezza") Nota sulla sicurezza: |
|---|
Il codice di esempio viene fornito per illustrare un concetto e non deve essere utilizzato in applicazioni o siti Web in quanto potrebbe non rappresentare le procedure di codifica più sicure. Microsoft esclude qualsiasi responsabilità di danni diretti o indiretti qualora il codice di esempio venga utilizzato per scopi diversi da quelli a cui è destinato. |
Per ottenere gli esempi e le istruzioni per l'installazione:
In Visual Studio scegliere Esempi dal menu ?.
Per ulteriori informazioni, vedere Individuazione dei file di esempio.
La versione più recente e l'elenco completo degli esempi sono disponibili in linea alla pagina Visual Studio 2008 Samples.
È anche possibile trovare gli esempi sul disco rigido del computer. Per impostazione predefinita, gli esempi e il file Leggimi vengono copiati in una cartella nel percorso \Programmi\Visual Studio 9.0\Samples\. Per le versioni Express di Visual Studio, tutti gli esempi sono disponibili in linea.
Generazione ed esecuzione dell'esempio
Per generare ed eseguire l'esempio
Aprire il file di soluzione tracetool.sln.
Scegliere Genera dal menu Genera.
Scegliere Avvia senza eseguire debug dal menu Debug.
.gif "Nota") Nota: |
|---|
Questa procedura è facoltativa. Se lo si desidera, in alternativa è possibile utilizzare il file AtlTraceTool.exe predefinito. |
Per utilizzare ATLTraceTool.exe
Eseguire il debug di un progetto MFC o ATL scegliendo Avvia dal menu Debug.
Nel caso in cui non sia in esecuzione, scegliere Strumento di analisi MFC/ATL dal menu Strumenti.
Espandere l'elenco del controllo struttura nella finestra Elenco analisi. Nella finestra verranno visualizzati l'applicazione in esecuzione, tutti i moduli inclusi nell'applicazione e le categorie di analisi per ciascun modulo.
Personalizzare le informazioni visualizzate nella finestra di output per ciascun processo, modulo e categoria. Il controllo Livello di analisi del gruppo Processo è correlato al livello di ATLTRACE2. Nella finestra di output verranno visualizzati solo i messaggi di ATLTRACE2 con un livello maggiore o uguale a quello impostato nel controllo Livello di analisi.
Scegliere Applica per attivare le impostazioni effettuate.
Per salvare le impostazioni e caricarle al successivo debug dell'applicazione, utilizzare i pulsanti Salva e Carica.
Interfaccia utente dello strumento di analisi ATL
Elenco analisi
Controllo struttura con un elenco di processi per i quali vengono utilizzate origini di debug ATL/MFC. Sotto ad ogni processo sono elencati i moduli e sotto ad ogni modulo sono elencate le categorie di analisi.Aggiorna
Consente di aggiornare l'elenco dei processi e dei moduli in Elenco analisi.Gruppo Processo
Impostazioni a livello di processo:Livello di analisi – Corrisponde al parametro del livello di analisi nelle chiamate a ATLTRACE2. Attualmente nelle origini ATL/MFC viene utilizzato un livello di analisi compreso tra 0 e 4, dove 0 è il livello più critico.
Attivata – Consente di attivare l'analisi per il processo.
Nomi categorie e funzioni – Consente di includere la categoria di analisi e il nome di funzione nei messaggi di analisi.
Nome file e numero riga – Consente di includere il nome del file e il numero della riga nei messaggi di analisi.
Gruppo Modulo
Questo gruppo viene attivato dopo che è stato selezionato un modulo nel controllo struttura Elenco analisi. Le impostazioni riportate di seguito vengono applicate al modulo.Livello di analisi – Corrisponde al parametro del livello di analisi nelle chiamate a ATLTRACE2. Attualmente nelle origini ATL/MFC viene utilizzato un livello di analisi compreso tra 0 e 4, dove 0 è il livello più critico.
Eredita dal processo – Consente di utilizzare le impostazioni di analisi del gruppo Processo anche per questo modulo.
Attivata – Consente di attivare l'analisi per questo modulo.
Disattivata – Consente di disattivare l'analisi per questo modulo.
Gruppo Categoria
Questo gruppo viene attivato dopo che è stata selezionata una categoria nel controllo struttura Elenco analisi. Le impostazioni riportate di seguito vengono applicate alla categoria all'interno del modulo.Livello di analisi – Corrisponde al parametro del livello di analisi nelle chiamate a ATLTRACE2. Attualmente nelle origini ATL/MFC viene utilizzato un livello di analisi compreso tra 0 e 4, dove 0 è il livello più critico.
Eredita dal modulo – Consente di utilizzare le impostazioni di analisi del gruppo Modulo anche per questa categoria.
Attivata – Consente di attivare l'analisi per questa categoria.
Disattivata – Consente di disattivare l'analisi per questa categoria.
Save
Consente di salvare le impostazioni per il processo corrente e per tutti i moduli sotto di esso in un file TRC. Il file TRC può essere caricato utilizzando il pulsante Carica oppure chiamando AtlTraceLoadSettings dal progetto. Se il file TRC si trova nella stessa directory del file EXE/DLL, è possibile chiamare AtlTraceLoadSettings e passare NULL come nome del file.Caricamento
Consente di caricare un file TRC.Apply
Consente di applicare le impostazioni correnti al processo caricato.Close
Consente di chiudere la finestra di dialogo Strumento di analisi ATL/MFC. Le modifiche diventeranno effettive solo dopo aver selezionato Applica.Help
Consente di visualizzare la Guida in linea.