次の方法で共有

ATLTraceTool サンプル : ATLTRACE2 の出力の表示

  • [アーティクル]

更新 : 2007 年 11 月

ATLTraceTool サンプルでは、出力ウィンドウに表示される ATLTRACE2 メッセージを指定するアプリケーションをビルドします。この ATL Trace Tool アプリケーションは、ATL ソースと MFC ソースにデバッグ トレース メッセージを表示します。表示されるメッセージの種類と容量は制御できます。

AtlTraceTool.exe は Visual Studio に付属しており、\Program Files\Microsoft Visual Studio 9.0\Common7\Tools ディレクトリにあります。AtlTraceTool.exe は、開発環境の [ツール] メニューで使用できます。

khbh432d.alert_security(ja-jp,VS.90).gifセキュリティに関するメモ :

このサンプル コードは概念を示す目的で提供されているものです。必ずしも最も安全なコーディング手法に従っているわけではないため、アプリケーションまたは Web サイトでは使用しないでください。Microsoft は、サンプル コードが意図しない目的で使用された場合に、付随的または間接的な損害について責任を負いません。

サンプルとそのインストール手順を取得するには

  • Visual Studio で、[ヘルプ] メニューの [サンプル] をクリックします。

    詳細については、「サンプル ファイルの格納場所」を参照してください。

  • 使用できるサンプルの最新バージョンと完全な一覧については、オンラインの Visual Studio 2008 Samples のページを参照してください。

  • サンプルは、コンピュータのハード ディスク上にもあります。既定では、サンプルおよび Readme ファイルは、\Program Files\Visual Studio 9.0\Samples\ の下のフォルダにコピーされます。Visual Studio Express Edition の場合、すべてのサンプルはオンライン上にあります。

サンプルのビルドと実行

このサンプルをビルドして実行するには

  1. ソリューション ファイル tracetool.sln を開きます。

  2. [ビルド] メニューの [ビルド] をクリックします。

  3. [デバッグ] メニューの [デバッグなしで開始] をクリックします。

khbh432d.alert_note(ja-jp,VS.90).gifメモ :

この処理手順は省略できます。必要に応じて、ビルド済みの AtlTraceTool.exe を使用できます。

ATLTraceTool.exe を使用するには

  1. [デバッグ] メニューの [開始] をクリックして、MFC プロジェクトまたは ATL プロジェクトをデバッグします。

  2. まだ実行されていない場合は、[ツール] メニューの [MFC/ATL トレース ツール] をクリックします。

  3. [Trace List] ウィンドウのツリー コントロール リストを展開します。このウィンドウには、実行中のアプリケーション、そのアプリケーション内のすべてのモジュール、および各モジュールのトレース カテゴリが表示されます。

  4. 各プロセス、モジュール、およびカテゴリについて、出力ウィンドウに表示する情報をカスタマイズします。[Process] グループの [Trace level] コントロールは ATLTRACE2 レベルに関連しており、[Trace level] コントロールで設定されたレベル以上の ATLTRACE2 メッセージだけが出力ウィンドウに表示されます。

  5. [Apply] をクリックして、設定を有効にします。

[Save] をクリックすると、設定を保存できます。また、[Load] をクリックすると、アプリケーションをデバッグするときにこの設定を読み込むことができます。

ATL Trace Tool のユーザー インターフェイス

  • [Trace List]
    デバッグ ATL/MFC ソースを使用するプロセスの一覧があるツリー コントロール。各プロセスの下にモジュールが一覧表示され、各モジュールの下にはトレース カテゴリが一覧表示されます。

  • [Refresh]
    [Trace List] のプロセスとモジュールの一覧を更新します。

  • [Process Group]
    以下に示すようなプロセス全体の設定です。

    [Trace level] – ATLTRACE2 を呼び出す場合のトレース レベル パラメータと同じです。現在、ATL/MFC ソースでは、トレース レベル 0 ～ 4 を使用します。0 は最も重大なレベルです。

    [Enabled] – プロセスのトレースを有効にします。

    [Category & Function Names] – トレース カテゴリと関数名をトレース メッセージに組み込みます。

    [File Name & Line No.] – トレース メッセージにファイル名と行番号を含めます。

  • [Module Group]
    このグループを有効にするには、まず [Trace List] ツリー コントロールでモジュールを選択する必要があります。これらの設定はモジュールに影響します。

    [Trace level] – ATLTRACE2 を呼び出す場合のトレース レベル パラメータと同じです。現在、ATL/MFC ソースでは、トレース レベル 0 ～ 4 を使用します。0 は最も重大なレベルです。

    [Inherit from Process] – このモジュールでも使用する [Process] グループでトレース設定を可能にします。

    [Enabled] – このモジュールのトレースを有効にします。

    [Disabled] – このモジュールのトレースを無効にします。

  • [Category Group]
    このカテゴリを有効にするには、まず [Trace List] ツリー コントロールでモジュールを選択する必要があります。これらの設定はモジュール内のカテゴリに影響します。

    [Trace level] – ATLTRACE2 を呼び出す場合のトレース レベル パラメータと同じです。現在、ATL/MFC ソースでは、トレース レベル 0 ～ 4 を使用します。0 は最も重大なレベルです。

    [Inherit from Module] – このカテゴリでも使用する [Module] グループでトレース設定を可能にします。

    [Enabled] – このカテゴリのトレースを有効にします。

    [Disabled] – このカテゴリのトレースを無効にします。

  • [Save]
    現在のプロセスとその下のすべてのモジュールの設定を .trc ファイルに保存します。.trc ファイルは、[Load] を使用するか、またはプロジェクトから AtlTraceLoadSettings を呼び出すことで読み込むことができます。.trc ファイルが EXE/DLL と同じディレクトリにある場合、AtlTraceLoadSettings を呼び出してこのファイル名に NULL を渡すことができます。

  • [Load]
    .trc ファイルを読み込みます。

  • [Apply]
    読み込みまれたプロセスに現在の設定を適用します。

  • [Close]
    [ATL/MFC Trace Tool] ダイアログ ボックスを閉じます。[Apply] を選択しない限り、変更内容は有効になりません。

  • [Help]
    ヘルプを表示します。

参照

その他の技術情報

ATL サンプル