[VC++ ディレクトリ] プロパティ ページ (Windows)

このプロパティ ページを使用して、現在選択されているプロジェクトをビルドするときに使用するディレクトリを Visual Studio に指示します。 ソリューション内の複数のプロジェクトについてディレクトリを設定するには、Visual Studio C++ プロジェクト設定の共有または再利用に関するページの説明に従って、カスタム プロパティ シートを使用します。

このページの Linux バージョンについては、「VC++ ディレクトリ (Linux C++)」を参照してください。

[VC++ ディレクトリ] プロパティ ページにアクセスするには:

  1. ソリューション エクスプローラー ウィンドウが表示されない場合は、メイン メニューで [表示]>[ソリューション エクスプローラー] の順に選択します。

  2. (最上位のソリューションではなく) プロジェクト ノードを右クリックし、[プロパティ] を選択して、[プロパティ ページ] ダイアログ ボックスを開きます。

  3. [構成プロパティ]>[VC++ ディレクトリ] プロパティ ページを選択します。

[VC++ ディレクトリ] プロパティは、最上位のソリューション ノードではなく、プロジェクトに適用されます。 [構成プロパティ] の下に [VC++ ディレクトリ] が表示されない場合は、[ソリューション エクスプローラー] ウィンドウで C++ プロジェクト ノードを選択します。

Screenshot of the Solution Explorer window with the Project node selected.

[プロパティ ページ] ダイアログで、VC++ ディレクトリ>構成プロパティが選択されています。 実行可能ディレクトリ、インクルード ディレクトリ、ライブラリ ディレクトリ、ソース ディレクトリなど、さまざまな C++ ディレクトリが一覧表示されます。

クロスプラット フォーム プロジェクトの [VC++ ディレクトリ] プロパティ ページは外観が異なります。 Linux C++ プロジェクトに固有の情報については、「VC++ ディレクトリ (Linux C++)」を参照してください。

Visual Studio のプロジェクト プロパティに慣れていない場合は、最初に「Visual Studio で C++ コンパイラとビルド プロパティを設定する」を読むと役に立ちます。

VC++ ディレクトリ プロパティの既定の設定は、プロジェクトの種類によって異なります。 デスクトップ プロジェクトの場合、特定のプラットフォーム ツールセットの C++ ツールの場所と、Windows SDK の場所が含まれます。 プラットフォーム ツールセットWindows SDK バージョンは、[構成プロパティ]>[全般] ページで変更できます。

いずれかのディレクトリの値を表示するには:

  1. [VC++ ディレクトリ] ページで、プロパティのいずれか 1 つを選択します。 たとえば、[ライブラリ ディレクトリ] を選択します。
  2. プロパティの値フィールドの末尾にある下向きの矢印ボタンを選択します。
  3. ドロップダウン メニューで [編集] を選択します。

Detail of the Library Directories property drop-down with the Edit command highlighted.

次のようなダイアログ ボックスが表示されます。

Screenshot of the Library Directories dialog.

ライブラリ ディレクトリ ダイアログには、ライブラリ ディレクトリ領域と、すべてのマクロが展開された後のパス値を示す評価値領域があります。 親またはプロジェクトから継承されたマクロ値を示す継承値領域があります。 親またはプロジェクトの既定値から継承するというチェックボックスがチェックされています。 マクロ ボタンと [OK] ボタンと [キャンセル] ボタンがあります。

現在のディレクトリを表示するには、このダイアログ ボックスを使用します。 ただし、ディレクトリを変更または追加する場合は、プロパティ マネージャーを使用してプロパティ シートを作成するか、既定のユーザー プロパティ シートを変更することをお勧めします。 詳細については、Visual Studio C++ プロジェクト設定の共有または再利用に関するページを参照してください。

前に示したように、継承されたパスの多くはマクロとして提供されます。 マクロの現在の値を調べるには、ダイアログ ボックスの右下隅の [マクロ] ボタンを選択します。 多くのマクロは、構成の種類に依存しています。 たとえば、デバッグ ビルドのマクロは、リリース ビルドの同じマクロとは異なるパスに評価される場合があります。 マクロ値の検査については、ビルド コマンドとプロパティの一般的なマクロを参照してください

編集ボックスで、マクロの部分的または完全な一致を検索できます。 次のスクリーンショットは、文字列 "WindowsSDK" を含むすべてのマクロを示しています。 また、各マクロによって評価される現在のパスも表示されます。

Screenshot of the Library Directories dialog with the list of macro values displayed.

[ライブラリ ディレクトリ] ダイアログが表示され、フィルター処理されたマクロの一覧が表示されます。 結果には、$ (Windows SDK _ 実行可能パス)、$ (Windows SDK _ インクルード パス)、$ (Windows SDK _ ライブラリ パス)、その他など、文字列 "WindowsSDK" を含むマクロが含まれます。 親またはプロジェクトから継承されるマクロ値を示す継承値領域があります。 すべてのマクロが展開された後のパス値を示す評価値領域があります。 親またはプロジェクトの既定値から継承するというチェックボックスがチェックされています。 マクロ ボタンと、[挿入]、[OK]、[キャンセル] ボタンがあります。

入力した内容がこのリストに表示されます。 Enter キーを押さないでください。

マクロの詳細と、ハードコーディングされたパスの代わりに可能な限りマクロを使用すべき理由については、「Visual Studio で C++ コンパイラとビルド プロパティを設定する」を参照してください。

マクロの値を調べる方法については、ビルド コマンドとプロパティの一般的なマクロを参照してください。 このトピックでは、一般的に使用されるマクロの一覧も示します。

独自のマクロは次の 2 通りの方法で定義できます。

  • 開発者コマンド プロンプトで環境変数を設定します。 すべての環境変数は、MSBuild プロパティ/マクロとして扱われます。

  • .props ファイルでユーザー マクロを定義します。 詳細については、「Property page macros」 (プロパティ ページ マクロ) を参照してください。

詳細については、「Visual Studio プロジェクトでのプロパティの継承」と、VC++ ディレクトリVisual Studio 2010 C++ プロジェクト アップグレード ガイドに関するブログの投稿を参照してください。

全般

また、次のように、その他のディレクトリも指定できます。

実行ファイル ディレクトリ
実行可能ファイルを検索するディレクトリ。 PATH 環境変数と対応します。

インクルード ディレクトリ
ソース コードで参照されるインクルード ファイルを検索するディレクトリ。 INCLUDE 環境変数と対応します。

外部インクルード ディレクトリ
コンパイル時に外部またはシステム ファイルとして扱うインクルード ファイルのパス。 これらのファイルは、ビルドの最新のチェックではスキップされます。 これらのパスは、External Includes プロパティでも使用されます。 IDE でこれらのオプションを設定する方法の詳細については、/external コンパイラ オプションに関するページを参照してください。

参照ディレクトリ
#using ディレクティブによってソース コード内で参照されるアセンブリおよびモジュール (メタデータ) ファイルを検索するディレクトリ。 LIBPATH 環境変数と対応します。

ライブラリ ディレクトリ
ライブラリ (.lib) ファイルを検索するディレクトリ。 この検索には、ランタイム ライブラリが含まれます。 LIB 環境変数と対応します。 この設定は、.obj ファイルには適用されません。.obj ファイルにリンクするには、[構成プロパティ]>[リンカー]>[全般] プロパティ ページで [Additional Library Dependencies]\(追加のライブラリ依存関係\) を選択してファイルの相対パスを指定します。 詳細については、「[リンカー] プロパティ ページ」を参照してください。

ライブラリ WinRT ディレクトリ
ユニバーサル Windows プラットフォーム (UWP) アプリで WinRT ライブラリ ファイルを検索するためのディレクトリ。

ソース ディレクトリ
IntelliSense で使用されるソース ファイルを検索するディレクトリ。

ディレクトリの除外
各コンパイルの前に、Visual Studio によってすべてのファイルのタイムスタンプが照会され、前回のコンパイルから変更されているものがあるかどうかが判断されます。 プロジェクトに多数の安定したライブラリがある場合は、タイムスタンプ チェックからこれらのディレクトリを除外することで、ビルド時間を短縮できる場合があります。

パブリック プロジェクト コンテンツ

パブリック インクルード ディレクトリ
このプロジェクトを参照するプロジェクトのインクルード パスに自動的に追加する 1 つまたは複数のディレクトリ。

すべてのヘッダー ファイルがパブリック
このプロジェクトを参照するプロジェクトのインクルード パスに、パブリック ディレクトリまたはすべてのプロジェクト ヘッダー ファイルを自動的に追加するかどうかを指定します。

パブリック C++ モジュール ディレクトリ
このプロジェクトを参照するプロジェクトで自動的に使用できる C++ モジュールまたはヘッダー ユニット ソースを含む 1 つまたは複数のディレクトリ。

すべてのモジュールがパブリック
すべてのプロジェクト モジュールとヘッダー ユニットを、このプロジェクトを参照するプロジェクトで自動的に使用できるようにするかどうかを指定します。

設定の共有

プロジェクトのプロパティを、他のユーザーと共有したり、複数のコンピューター間で共有したりできます。 詳しくは、「Visual Studio で C++ コンパイラとビルド プロパティを設定する」をご覧ください。