テクニカルノート 35: Visual C++ における複数のリソースファイルとヘッダーファイルの使用

[アーティクル]
07/19/2022

Note

次のテクニカルノートは、最初にオンラインドキュメントの一部とされてから更新されていません。結果として、一部のプロシージャおよびトピックが最新でないか、不正になります。最新の情報について、オンラインドキュメントのキーワードで関係のあるトピックを検索することをお勧めします。

このノートでは、Visual C++ のリソースエディターが、単一プロジェクト内または複数のプロジェクト間で共有されている複数のリソースファイルとヘッダーファイルをサポートする方法と、そのサポートを活用する方法について説明します。このノートでは、次の質問に回答します。

単一プロジェクトを複数のリソースファイルやヘッダーファイルに分割するのはどのような場合ですか。また、どのような方法で分割しますか
2 つの .RC ファイルの間で、共通の .H ヘッダーファイルをどのように共有しますか
プロジェクトリソースをどのように複数の .RC ファイルに分割しますか
.RC、.CPP、.H の各ファイル間のビルド依存関係を手動 (およびツール) でどのように管理しますか

プロジェクトに追加のリソースファイルを追加した場合は、追加されたファイル内のリソースを ClassWizard が認識しないことに注意してください。

このノートは、上記の質問に回答するために次のように構成されています。

「Visual C++ でリソースファイルとヘッダーファイルを管理する方法の概要」では、Visual C++ のリソースセットインクルードコマンドにより、同じプロジェクト内で複数のリソースファイルとヘッダーファイルを使用できるようにする方法の概要について説明します。
「AppWizard で作成された .RC と .H ファイルの分析」では、AppWizard で作成されたアプリケーションによって使用される複数のリソースファイルとヘッダーファイルを確認します。これらのファイルは、プロジェクトに追加する可能性のあるリソースファイルやヘッダーファイルの適切なモデルとして機能します。
「追加のヘッダーファイルのインクルード」では、複数のヘッダーファイルをインクルードすることが必要となる可能性のある状況と、その作業を行う方法の詳細について説明します。
「2 つの .RC ファイル間でのヘッダーファイルの共有」では、異なるプロジェクト内、または多くの場合は同じプロジェクト内にある複数の .RC ファイルの間で 1 つのヘッダーファイルを共有する方法を示します。
「同じプロジェクト内での複数のリソースファイルの使用」では、プロジェクトを複数の .RC ファイルに分割することが必要となる可能性のある状況と、その作業を行う方法の詳細について説明します。
「編集不可の Visual C++ ファイルの適用」では、Visual C++ によるカスタムリソースの編集や意図しない書式の再設定を確実に防止する方法について説明します。
「Visual C++ で編集した複数の .RC ファイルで共有されるシンボルの管理」では、複数の .RC ファイル間で同じシンボルを共有する方法と、重複する ID 数値の割り当てを防止する方法について説明します。
「.RC、.CPP、.H ファイル間の依存関係の管理」では、リソースシンボルファイルに依存する .CPP ファイルの不要な再コンパイルを Visual C++ が回避する方法について説明します。
「Visual C++ による [インクルードファイルの設定] 情報の管理方法」では、Visual C++ が複数の (入れ子になっている) .RC ファイルと、#include によって .RC ファイル内にインクルードされた複数のヘッダーファイルを追跡する方法に関する技術的な詳細を提供します。

Visual C++ がリソースファイルとヘッダーファイルを管理する方法の概要

Visual C++ では、単一の .RC リソースファイルとそれに対応する .H ヘッダーファイルを、緊密に結合されたファイルペアとして管理します。 .RC ファイル内でリソースを編集および保存すると、対応する .H ファイル内でシンボルを間接的に編集および保存することになります。 (Visual C++ の MDI ユーザーインターフェイスを使用して) 一度に複数の .RC ファイルを開いて編集することができますが、任意の .RC ファイルを対象として、ただ 1 つの対応するヘッダーファイルを間接的に編集していることになります。

リソースビューの [リソースインクルード] ダイアログ

Resource Includes にアクセスするには、リソースビューに移動し、.rc ファイルを右クリックして[リソースインクルード]を選択します。

[シンボル用のヘッダーファイル]

既定では、リソースファイル (たとえば、MYAPP.RC) の名前にかかわりなく、Visual C++ は対応するヘッダーファイルに必ず RESOURCE.H という名前を付けます。 Visual C++ の [リソースインクルード] ダイアログの [シンボルヘッダーファイル: ] セクションでは、このヘッダーファイルの名前を変更できます。セクションの編集ボックスに新しいファイル名を入力します。

注意

リソースファイルが、.RC ファイルを正しく読み取るために、相対パスの前に escaped-'\' を付ける必要があります。

[読み取り専用ヘッダーファイル]

Visual C++ はどの特定の .RC ファイルに対しても 1 つのヘッダーファイルのみを編集しますが、Visual C++ では追加の読み取り専用ヘッダーファイル内で定義されているシンボルへの参照をサポートします。 Visual C++ の [リソースインクルード] ダイアログの [読み取り専用シンボルディレクティブ: ] セクションでは、任意の数の追加の読み取り専用ヘッダーファイルをシンボルディレクティブRead-Only指定できます。 "読み取り専用" という制限は .RC ファイル内で新しいリソースを追加するときに、読み取り専用ヘッダーファイル内で定義されたシンボルを使用できること、ただし、リソースを削除した場合でも、シンボルは引き続き読み取り専用ヘッダーファイル内で定義されたままになることを意味します。読み取り専用シンボルに対して割り当てられた数値を変更することはできません。

[コンパイル時に追加するファイル]

Visual C++ ではリソースファイルの入れ子、つまり .RC ファイルの中で #include を使用し、他の .RC ファイルをインクルードする方法をサポートしています。 Visual C++ を使用して特定の .RC ファイルを編集すると、#include によってインクルードされたファイル内のどのリソースも表示されません。ただし、その .RC ファイルをコンパイルするときに、#include によってインクルードされたファイルもコンパイルされます。 Visual C++ の [リソースインクルード] ダイアログの [コンパイル時ディレクティブ: ] セクションでは、任意の数の#includeを指定できます。RC ファイルを Compile-Time ディレクティブとして使用します。

[コンパイル時に追加するファイル] として指定されて "いない" 他の .RC ファイルを #include によってインクルードした .RC ファイルを Visual C++ に読み取るときに、何が起こるかに注意してください。この状況は、以前にテキストエディターを使用して手動で保守していた .RC ファイルを、Visual C++ に読み込む場合に発生する可能性があります。 Visual C++ はインクルードされた .RC ファイルを読み取る場合は、インクルードされたリソースを親 .RC ファイルにマージします。親 .RC ファイルを保存するときに、#include ステートメントは実際には、インクルードされたリソースで置き換えられます。このマージが発生することを望まない場合は、親 .RC ファイルを Visual C++ で読み取る "前に"、それから #include ステートメントを削除する必要があります。その後、Visual C++ を使用して、[コンパイル時に追加するファイル] として、同じ #include ステートメントをもう一度追加します。

Visual C++ は、#include ディレクティブ "および" TEXTINCLUDE リソースを使用して、1 つの .RC ファイル内に、上記の [インクルードファイルの設定] の 3 種類の情報 ([シンボル用のヘッダーファイル]、[読み取り専用ヘッダーファイル]、および [コンパイル時に追加するファイル]) を保存します。 TEXTINCLUDE リソース、および実装の詳細は、開発者が通常取り扱う必要はありませんが、「Visual C++ による [インクルードファイルの設定] 情報の管理方法」に掲載されています。

AppWizard で作成した .RC ファイルと .H ファイルの分析

AppWizard が生成したアプリケーションコードを調べると、Visual C++ が複数のリソースファイルとヘッダーファイルを管理する方法を把握できます。以下で検討するコードは、既定のオプションを使用して AppWizard で生成した MYAPP アプリケーションから抜粋したものです。

AppWizard で作成したアプリケーションは、次の図に要約するように、複数のリソースファイルと複数のヘッダーファイルを使用します。

   RESOURCE.H     AFXRES.H
          \       /
           \     /
          MYAPP.RC
              |
              |
        RES\MYAPP.RC2
        AFXRES.RC
        AFXPRINT.RC

Visual C++ の [ファイル] - [インクルードファイルの設定] コマンドを使用して、これら複数のファイルの関係を表示できます。

MYAPP.RC
Visual C++ を使用して編集する、アプリケーションのリソースファイル。

RESOURCE.H は、アプリケーション固有のヘッダーファイルです。 Visual C++ のヘッダーファイルの既定の名前付けに整合した方法で、このファイルに対して AppWizard によって必ず RESOURCE.H という名前が付けられます。このヘッダーファイルに対応する #include は、リソースファイル (MYAPP.RC) 内の最初のステートメントです。

//Microsoft Visual C++ generated resource script
//
#include "resource.h"

RES\MYAPP.RC2
Visual C++ の編集対象にならないが、最後にコンパイルされる .EXE ファイルに含まれることになるリソースが格納されています。 Visual C++ は (このリリースの新しい機能である) バージョンリソースを含め、標準のリソースすべてを編集できるため、AppWizard は既定ではこのようなリソースを作成しません。開発者が独自のカスタム形式リソースをこのファイルに追加しようとする場合は、AppWizard によって空のファイルが生成されます。

カスタム形式リソースを使用する場合は、そのリソースを RES\MYAPP.RC2 に追加し、Visual C++ のテキストエディターを使用して編集することができます。

AFXRES.RC と AFXPRINT.RC には、フレームワークの一部の機能で必要とされる標準的なリソースが含まれます。 RES\MYAPP.RC2 と同様に、フレームワークによって提供されるこれらの 2 つは MYAPP.RC の最後にインクルードされるリソースファイルです。またこれらは、[インクルードファイルの設定] ダイアログボックスの [コンパイル時に追加するファイル] で指定されます。したがって、Visual C++ で MYAPP.RC を編集するときに、これらのフレームワークリソースを直接表示または編集することはありませんが、これらはアプリケーションのバイナリ .RES ファイルと最終的な .EXE ファイルにコンパイルされます。標準的なフレームワークリソースの詳細 (これらを変更する手順など) については、テクニカルノート 23 を参照してください。

AFXRES.H は、フレームワークによって使用され、特に AFXRES.RC 内で使用される、ID_FILE_NEW のような標準的なシンボルを定義します。また、AFXRES.H 内の #include で指定されている WINRES.H には、WINDOWS.H のサブセットが含まれていて、これらは AFXRES.RC と同様、Visual C++ によって生成される .RC ファイルで必要とされるものです。 AFXRES.H 内で定義されたシンボルは、アプリケーションのリソースファイル (MYAPP.RC) を編集するときに使用できます。たとえば、ID_FILE_NEW は MYAPP.RC 内のメニューリソースにある File New メニュー項目に関連して使用されます。フレームワークで定義されたこれらのシンボルを変更または削除することはできません。

追加のヘッダーファイルのインクルード

AppWizard で作成したアプリケーションには、RESOURCE.H、および AFXRES.H という 2 つのヘッダーファイルのみが含まれています。 RESOURCE.H のみがアプリケーション固有です。次の状況では、追加の読み取り専用なヘッダーファイルをインクルードする必要が生じることがあります。

ヘッダーファイルは、外部ソースから提供することがあります。または、複数のプロジェクト間でヘッダーファイルを共有するか、同じプロジェクトの複数の部分で共有することもあります。

ヘッダーファイルには形式とコメントがあり、そのファイルを保存するときに、Visual C++ がこれらに変更を加えるか除外することは望ましくありません。たとえば、次のようにシンボル算術演算を使用する #define を保持したいとします。

#define RED 0
#define BLUE 1
#define GREEN 2
#define ID_COLOR_BUTTON 1001
#define ID_RED_BUTTON (ID_COLOR_BUTTON + RED)
#define ID_BLUE_BUTTON (ID_COLOR_BUTTON + BLUE)
#define ID_GREEN_BUTTON (ID_COLOR_BUTTON + GREEN)

[リソースファイルのインクルード] コマンドを使用し、次のように #include ステートメントを 2 番目の [読み取り専用ヘッダーファイル] として指定することにより、追加の読み取り専用ヘッダーファイルをインクルードすることができます。

#include "afxres.h"
#include "second.h"

ファイル関係の新しい図は次のようになります。

                   AFXRES.H
    RESOURCE.H     SECOND.H
          \       /
           \     /
          MYAPP.RC
              |
              |
        RES\MYAPP.RC2  
        AFXRES.RC
        AFXPRINT.RC

異なるプロジェクト内、または多くの状況では同じプロジェクト内にある、2 つの .RC ファイル間で 1 つのヘッダーファイルを共有したいと考えることがあります。この作業を行うには、既に説明した [読み取り専用ヘッダーファイル] の手法を両方の .RC ファイルに適用します。 2 つの .RC ファイルが別のアプリケーション (別のプロジェクト) に対応している場合は、結果は次の図に示すとおりです。

     RESOURCE.H   AFXRES.H   RESOURCE.H  
    (for MYAPP1)  SECOND.H   (for MYAPP2)
          \       /     \       /
           \     /       \     /
          MYAPP1.RC      MYAPP2.RC
           /    \        /     \
          /      \      /       \
RES\MYAPP1.RC2  AFXRES.RC     RES\MYAPP2.RC2
                AFXPRINT.RC

2 番目のヘッダーファイルが、同じアプリケーション (プロジェクト) 内の 2 つの .RC ファイルによって共有される状況は、後で説明します。

同じプロジェクト内での複数のリソースファイルの使用

Visual C++ およびリソースコンパイラは、1 つの .RC ファイル内で #include を使用して別の .RC ファイルをインクルードする方法で、同じプロジェクト内で複数の .RC ファイルをサポートします。複数の入れ子も許可されます。プロジェクトのリソースを複数の .RC ファイルに分割するさまざまな理由があります。

リソースファイルを複数の .RC ファイルに分割した場合は、複数のプロジェクトチームメンバーの間で多数のリソースを容易に管理できるようになります。ファイルのチェックアウトおよび変更のチェックインの目的でソース管理パッケージを使用する場合は、リソースを複数の .RC ファイルに分割すると、リソースに対する変更の管理全体をより詳細に制御できるようになります。
#ifdef、#endif、#define のようなプリプロセッサディレクティブを使用する場合は、リソースの一部を対象として、リソースコンパイラによってコンパイルされる読み取り専用リソースの中にそれらを分離する必要があります。
Visual C++ の中で、複数のコンポーネント .RC ファイルの読み込みと保存は、1 つの複合 .RC ファイルより高速に実行されます。
テキストエディターを使用して、人間が認識できる形式のリソースを維持することを希望する場合は、Visual C++ で編集する .RC ファイルとは別の .RC ファイルを用意し、その中で維持する必要があります。
ユーザー定義のリソースを、別の特殊なデータエディターで解釈できるバイナリまたはテキスト形式で保持する必要がある場合は、別の .RC ファイルでそのリソースを維持する必要があります。その結果、Visual C++ が形式を 16 進データに変更することはありません。 MFC の高度な概念のサンプル SPEAKN 内の .WAV (サウンド) ファイルリソースは適切な例です。

[インクルードファイルの設定] ダイアログボックス内の [コンパイル時に追加するファイル] で、SECOND.RC の #include を指定できます。

#include "res\myapp.rc2"  // non-Visual C++ edited resources
#include "second.rc"  // THE SECOND .RC FILE

#include "afxres.rc"  // Standard components
#include "afxprint.rc"  // printing/print preview resources

結果は次の図のようになります。

   RESOURCE.H     AFXRES.H
          \       /
           \     /
          MYAPP.RC
              |
              |
        RES\MYAPP.RC2
        SECOND.RC  
        AFXRES.RC
        AFXPRINT.RC

[コンパイル時に追加するファイル] を使用して、Visual C++ で編集可能なリソースと編集不可能なリソースを複数の .RC ファイルに編成することができます。ここで、"マスター" の MYAPP.RC は、他の .RC ファイルの #include を行うだけで、それ以外は何もしません。 Visual Studio C++ プロジェクト .MAK ファイルを使用する場合は、プロジェクト内に "マスター" .RC ファイルをインクルードする必要があります。その結果、#include によってインクルードされているすべてのリソースがアプリケーションにコンパイルされます。

編集不可能な Visual C++ ファイルの適用

AppWizard で作成した RES\MYAPP.RC2 ファイルは、Visual C++ で誤って読み取り、形式情報を失って書き戻すことを "避ける" 必要があるリソースを含むファイルの例です。このような事態を防止するには、RES\MYAPP.RC2 ファイルの先頭に次の行を記述します。

#ifdef APSTUDIO_INVOKED
    #error this file is not editable by Visual C++
#endif //APSTUDIO_INVOKED

Visual C++ は .RC ファイルをコンパイルするときに、APSTUDIO_INVOKED および RC_INVOKED を定義します。仮に AppWizard で作成したファイル構造が破損していて、Visual C++ が上記の #error 行を読み取った場合は、Visual C++ は致命的なエラーを報告し、.RC ファイルの読み取りを中止します。

Visual C++ で編集した複数の .RC ファイルで共有されるシンボルの管理

リソースを複数の .RC ファイルに分割し、それらを Visual C++ で個別に編集する場合は、2 つの問題が生じます。

複数の .RC ファイル間で同じシンボルを共有したいと考えることがあります。
個別のリソース (シンボル) に同じ ID 数値を割り当てることを避けるために、Visual C++ を支援する必要があります。

次の図に、最初の問題に対処するための .RC ファイルと .H ファイルの構成を示します。

              MYAPP.RC
             /         \
            /           \
MYSTRS.H   / MYSHARED.H  \  MYMENUS.H
     \    /    /      \   \    \
      \  /    /        \   \    \
      MYSTRS.RC         MYMENUS.RC

この例では、文字列リソースを 1 つのリソースファイル、MYSTRS.RC に保存し、メニューを別のファイル、MYMENUS.RC で保持します。コマンドなどに対応する一部のシンボルは、2 つのファイル間で共有する必要が生じることがあります。たとえば、ID_TOOLS_SPELL は、[ツール] メニューの [スペル] 項目に対応するメニューコマンド ID である可能性があります。または、これは、アプリケーションのメインウィンドウのステータスバー内で、フレームワークによって表示されるコマンドプロンプトの文字列 ID である可能性もあります。

ID_TOOLS_SPELL シンボルは、共有ヘッダーファイル、MYSHARED.H 内で保持されます。開発者はテキストエディターを使用し、この共有ヘッダーファイルを手動で保守します。Visual C++ がこのファイルを直接編集することはありません。 2 つのリソースファイル MYSTRS.RC と MYMENUS.RC の中で、前述のように [リソースファイルのインクルード] コマンドを使用して、MYAPP.RC に対する [読み取り専用のヘッダーファイル] の中で #include MYSHARED.H を指定します。

シンボルを使用してリソースを識別しようとする前に、どのシンボルを共有する予定なのか予測すると便利です。シンボルを共有ヘッダーファイルに追加します。.RC ファイルに対応する [読み取り専用のヘッダーファイル] の中でまだ共有ヘッダーファイルをインクルードしていない場合は、そのシンボルを使用する前に、#include を指定します。シンボルをこの方法で共有することを想定していない場合は、たとえばシンボルを MYSTRS.RC 内で使用する前に、シンボルに対応する #define ステートメントを (テキストエディターを使用して) 手動で MYMENUS.H から MYSHARED.H に移動する必要が生じます。

複数の .RC ファイル内でシンボルを管理する場合も、個別のリソース (シンボル) に対して同じ ID 数値を割り当てることを防止するために、Visual C++ を支援する必要があります。特定の .RC ファイルに対して、Visual C++ は 4 つの ID ドメインのそれぞれで、インクリメンタル形式で ID を割り当てます。複数の編集セッションの間も、Visual C++ は .RC ファイルに対応するシンボルヘッダーファイルの各ドメインで自らが最後に割り当てた ID を追跡しています。次に、空の (新しい) .RC ファイルに対応する APS_NEXT の値を示します。

#define _APS_NEXT_RESOURCE_VALUE  101
#define _APS_NEXT_COMMAND_VALUE   40001
#define _APS_NEXT_CONTROL_VALUE   1000
#define _APS_NEXT_SYMED_VALUE     101

_APS_NEXT_RESOURCE_VALUE は、ダイアログリソース、メニューリソースなどを対象として使用する次のシンボル値です。リソースシンボル値の有効な値の範囲は 1 ～ 0x6FFF です。

_APS_NEXT_COMMAND_VALUE は、コマンド ID を対象として使用する次のシンボル値です。コマンドシンボル値の有効な値の範囲は 0x8000 ～ xDFFF です。

_APS_NEXT_CONTROL_VALUE は、ダイアログコントロールを対象として使用する次のシンボル値です。ダイアログコントロール値の有効な値の範囲は 8 ～ 0xDFFF です。

_APS_NEXT_SYMED_VALUE は、シンボルブラウザー内で [新規] コマンドを使用して手動でシンボル値を割り当てるときに発行される次のシンボル値です。

Visual C++ は、新しい .RC ファイルを作成するときに、最小の有効な値より少し大きい値を使用して割り当てを開始します。 AppWizard も、これらの値を、MFC アプリケーションに適切な値より少し大きい値に初期化します。 ID の値範囲の詳細については、テクニカルノート 20 を参照してください。

これで、同じプロジェクト内であっても、新しいリソースファイルを作成するたびに、Visual C++ は _APS_NEXT_ の同じ値を定義します。これは、たとえば 2 つの異なる .RC ファイルの中で複数のダイアログを追加する場合に、異なるダイアログに対して #define の同じ値が割り当てられる可能性が非常に高いことを意味します。たとえば、最初の .RC ファイル内の IDD_MY_DLG1 は、2 番目の .RC ファイル内にあるIDD_MY_DLG2 と同じ番号 101 を割り当てられる可能性があります。

これを回避するには、各 .RC ファイル内の 4 つの ID ドメインのそれぞれで、個別の数値範囲を予約する必要があります。この作業を行うには、リソースの追加を開始する前に、各 .RC ファイル内で _APS_NEXT の値を手動で更新します。たとえば、最初の .RC ファイルが既定の _APS_NEXT の値を使用する場合は、開発者は 2 番目の .RC ファイルに対して _APS_NEXT の次の値を割り当てることが考えられます。

#define _APS_NEXT_RESOURCE_VALUE  2000
#define _APS_NEXT_COMMAND_VALUE   42000
#define _APS_NEXT_CONTROL_VALUE   2000
#define _APS_NEXT_SYMED_VALUE     2000

もちろん、Visual C++ が最初の .RC ファイル内で多数の ID を割り当て、その結果、2 番目の .RC ファイル用に予約した ID 数値との重複が始まる可能性はあります。この現象が発生しないように、十分に大きい範囲を予約する必要があります。

.RC、.CPP、.H ファイル間の依存関係の管理

Visual C++ は .RC ファイルを保存するときに、シンボルに対する変更を、対応する RESOURCE.H ファイルに保存します。 .RC ファイル内のリソースを参照するあらゆる .CPP ファイルは、RESOURCE.H ファイルの #include を行う必要があります。これは通常、プロジェクトのマスターヘッダーファイル内で行うことになります。この結果、ソースファイル内でヘッダーの依存関係をスキャンする開発環境の内部プロジェクト管理が原因で、望ましくない副作用につながります。 Visual C++ 内で新しいシンボルを追加するたびに、RESOURCE.H の #include を行うすべての .CPP ファイルを再コンパイルする必要が生じます。

Visual C++ では、RESOURCE.H ファイルの最初の行として次のコメントを含めることにより、RESOURCE.H の依存関係を回避できます。

//{{NO_DEPENDENCIES}}

開発環境では RESOURCE.H に対する変更を無視することによってこのコメントを解釈し、依存先の .CPP ファイルの再コンパイルを不要にします。

Visual C++ は .RC ファイルを保存するときに必ず、.RC ファイルに//{{NO_DEPENDENCIES}} コメント行を追加します。特定の状況では、RESOURCE.H に対するビルド依存関係を回避することが原因で、リンク時に検出されない実行時エラーが発生する可能性があります。たとえば、再コンパイルされないリソースを .CPP ファイルが参照している状況で、シンボルブラウザーを使用して、リソースのシンボルに対して割り当てられる数値を変更する場合は、そのリソースを正しく見つけることができず、アプリケーションの実行時にリソースが読み込まれません。このような場合は、RESOURCE.H 内でのシンボル変更の影響を受けることがわかっているすべての .CPP ファイルを明示的に再コンパイルするか、[すべてリビルド] を選択する必要があります。特定のリソースグループのシンボル値を頻繁に変更する必要がある場合は、前述のセクション「追加のヘッダーファイルのインクルード」で説明したように、それらのシンボルを個別の読み取り専用ヘッダーファイルに分割する方法が、多くの状況で利便性と安全性が向上するものと考えられます。

Visual C++ による [インクルードファイルの設定] 情報の管理方法

前述のように、[ファイル] メニューの [インクルードファイルの設定] コマンドで 3 種類の情報を指定できます。

[シンボル用のヘッダーファイル]
[読み取り専用ヘッダーファイル]
[コンパイル時に追加するファイル]

次に、Visual C++ がこれらの情報を .RC ファイル内で保持する方法について説明します。 Visual C++ を使用するうえでこの情報は必須ではありませんが、[インクルードファイルの設定] に関する理解を深め、より自信を持ってこの機能を使用できるようになる可能性があります。

[インクルードファイルの設定] の上記の 3 種類の情報それぞれは、.RC ファイル内に 2 つの形式で格納されます。(1) #include、またはリソースコンパイラで解釈可能な他のディレクティブ。および、(2) Visual C++ でのみ解釈買おうな特殊な TEXTINCLUDE リソース。

TEXTINCLUDE リソースの目的は、Visual C++ の [インクルードファイルの設定] ダイアログボックス内で容易に表現できる形式で、[インクルードファイルの設定] 情報を安全に格納することです。 TEXTINCLUDE は、Visual C++ によって定義されている "リソースの種類" です。 Visual C++ は、リソース ID 番号 1、2、および 3 を持つ、3 つの特定の TEXTINCLUDE リソースを認識します。

TEXTINCLUDE のリソース ID	[インクルードファイルの設定] 情報の種類
1	[シンボル用のヘッダーファイル]
2	[読み取り専用ヘッダーファイル]
3	[コンパイル時に追加するファイル]

[インクルードファイルの設定] 情報のそれぞれは、以下で説明するように、AppWizard で作成した既定の MYAPP.RC および RESOURCE.H ファイルによって表現されます。 BEGIN および END ブロックの間にある追加の \0 および "" トークンは、0 で終端された文字列と二重引用符のそれぞれを指定する RC の構文にとって必須です。

[シンボル用のヘッダーファイル]

リソースコンパイラによって解釈される [シンボル用のヘッダーファイル] 情報の形式は、単純な #include ステートメントです。

#include "resource.h"

対応する TEXTINCLUDE リソースは次のとおりです。

1 TEXTINCLUDE DISCARDABLE
BEGIN
    "resource.h\0"
END

[読み取り専用ヘッダーファイル]

[読み取り専用ヘッダーファイル] は、リソースコンパイラによる解釈が可能な次の形式で、MYAPP.RC の先頭でインクルードされます。

#include "afxres.h"

対応する TEXTINCLUDE リソースは次のとおりです。

2 TEXTINCLUDE DISCARDABLE
BEGIN
   "#include ""afxres.h""\r\n"
   "\0"
END

[コンパイル時に追加するファイル]

[コンパイル時に追加するファイル] は、リソースコンパイラによる解釈が可能な次の形式で、MYAPP.RC の最後でインクルードされます。

#ifndef APSTUDIO_INVOKED
///////////////////////
//
// From TEXTINCLUDE 3
//
#include "res\myapp.rc2"  // non-Visual C++ edited resources

#include "afxres.rc"  // Standard components
#include "afxprint.rc"  // printing/print preview resources
#endif  // not APSTUDIO_INVOKED

#ifndef APSTUDIO_INVOKED ディレクティブは、[コンパイル時に追加するファイル] をスキップするように Visual C++ に指示します。

対応する TEXTINCLUDE リソースは次のとおりです。

3 TEXTINCLUDE DISCARDABLE
BEGIN
"#include ""res\myapp.rc2""  // non-Visual C++ edited resources\r\n"
"\r\n"
"#include ""afxres.rc""  // Standard components\r\n"
"#include ""afxprint.rc""  // printing/print preview resources\r\n"
"\0"
END

テクニカル ノート 35: Visual C++ における複数のリソース ファイルとヘッダー ファイルの使用

Visual C++ がリソース ファイルとヘッダー ファイルを管理する方法の概要

リソース ビューの [リソースインクルード] ダイアログ

[シンボル用のヘッダー ファイル]

[読み取り専用ヘッダー ファイル]

[コンパイル時に追加するファイル]

AppWizard で作成した .RC ファイルと .H ファイルの分析

追加のヘッダー ファイルのインクルード

2 つの .RC ファイル間でのヘッダー ファイルの共有

同じプロジェクト内での複数のリソース ファイルの使用

編集不可能な Visual C++ ファイルの適用

Visual C++ で編集した複数の .RC ファイルで共有されるシンボルの管理

.RC、.CPP、.H ファイル間の依存関係の管理

Visual C++ による [インクルード ファイルの設定] 情報の管理方法

[シンボル用のヘッダー ファイル]

[読み取り専用ヘッダー ファイル]

[コンパイル時に追加するファイル]

関連項目

テクニカルノート 35: Visual C++ における複数のリソースファイルとヘッダーファイルの使用

Visual C++ がリソースファイルとヘッダーファイルを管理する方法の概要

リソースビューの [リソースインクルード] ダイアログ

[シンボル用のヘッダーファイル]

[読み取り専用ヘッダーファイル]

追加のヘッダーファイルのインクルード

2 つの .RC ファイル間でのヘッダーファイルの共有

同じプロジェクト内での複数のリソースファイルの使用

Visual C++ による [インクルードファイルの設定] 情報の管理方法

[シンボル用のヘッダーファイル]

[読み取り専用ヘッダーファイル]