プロパティページ (C++)

[アーティクル]
02/21/2013

プロパティページを使用すると、Visual Studio プロジェクトの設定を指定できます。Visual Studio プロジェクトの [プロパティページ] の場合は、ダイアログボックスを [プロジェクト] のメニューで開くことは、[プロパティ] をクリックします。

プロジェクト設定を指定してすべてのビルド構成に適用することも、各ビルド構成で異なるプロジェクトプロパティを指定することもできます。たとえば、リリース構成にはある設定を指定して、デバッグ構成には別の設定を指定できます。

使用可能なすべてのページが [プロパティページ] ダイアログボックスに表示されるわけではありません。表示されるページは、プロジェクト内のファイルの種類によって決まります。

詳細については、「方法 : [プロパティページ] でプロジェクトのプロパティを指定する」を参照してください。

既定のプロパティと. 変更されたプロパティ

プロジェクトの作成に [新しいプロジェクト] のダイアログボックスを使用すると Visual Studio は、プロジェクトのプロパティを初期化するには、指定されたプロジェクトテンプレートを使用します。したがって、テンプレートのプロパティ値は、そのプロジェクトの種類の既定値と考えることができます。他のプロジェクトの種類では、プロパティに別の既定値を指定できます。

プロジェクトのプロパティ値が変更された場合は、太字で表示されます。プロジェクトのプロパティが変更されるのは、次の理由によります:

プロジェクトテンプレートで指定されたものとは異なるプロパティ値が必要になったため、アプリケーションウィザードがプロパティを変更した場合。
[新しいプロジェクト] ダイアログボックスで、別のプロパティ値を指定した場合。
プロジェクトのプロパティページ、別のプロパティ値を指定した場合。

ヒント
プロジェクトをビルドするために MSBuild が使用する最初のプロパティ値のセットを確認するには、以下のコマンドラインで生成したプリプロセッサの出力ファイルを調べます: MSBuild /preprocess:preprocessor_output_filenameoptproject_filenameopt

プロパティのリセット

プロジェクトの [プロパティページ] ダイアログボックスを表示したとき、ソリューションエクスプローラーでプロジェクトノードが選択されている場合、多くのプロパティでは、[親またはプロジェクトの既定値から継承] を選択するか、または別の方法でプロパティ値を変更できます。

プロジェクトの [プロパティページ] ダイアログボックスを表示したとき、ソリューションエクスプローラーでファイルが選択されている場合、多くのプロパティでは、[親またはプロジェクトの既定値から継承] を選択するか、または別の方法でプロパティ値を変更できます。ただし、プロパティ値がプロジェクトの既定値とは異なる多くのファイルがプロジェクトに含まれる場合、そのプロジェクトのビルドにはより多くの時間がかかります。

ヒント
[プロパティページ] ダイアログボックスを更新して最新の選択内容を表示するには、[適用] をクリックします。

多くのプロジェクトの既定値は、システム (プラットフォーム) の既定値です。プロジェクトの既定値の一部は、そのプロジェクトの構成の [全般] プロパティページの [プロジェクトの既定値] セクションでプロパティを更新したときに適用されるスタイルシートから派生します。詳細については、「[全般] プロパティページ (プロジェクト)」を参照してください。

ユーザー定義の値の指定

一部のプロパティには、値を定義する必要があります。ユーザー定義の値には、1 文字以上の英数字、またはプロジェクトファイルのマクロ名を使用できます。そのような一部のプロパティではユーザー定義の値を 1 つだけ指定できますが、それ以外のプロパティには複数の値をセミコロンで区切った一覧を指定できます。

プロパティにユーザー定義の値を指定する (複数のユーザー定義の値を指定できるプロパティの場合には値の一覧を指定する) には、プロパティ名の右側の列で、次のいずれかの操作を実行します。

値、または値の一覧を入力します。
ドロップダウン矢印をクリックします。テキストボックスで [編集] を使用できる場合はそれをクリックして、値または値の一覧を入力します。一覧を指定するもう 1 つの方法は、テキストボックスで 1 行に 1 つずつ値を入力します。プロパティページでは、それらの値がセミコロンで区切られた一覧として表示されます。

プロジェクトファイルマクロを値として挿入するには、[マクロ] をクリックして、マクロ名をダブルクリックします。
ドロップダウン矢印をクリックします。[参照] を使用できる場合は、それをクリックして 1 つまたは複数の値を選択します。

複数の値を持つプロパティの場合は、プロパティ名の右側の列のドロップダウン矢印をクリックして [編集] をクリックすると、[親またはプロジェクトの既定値から継承] オプションを使用できるようになります。既定では、このチェックボックスはオンになっています。

プロパティページには、別のレベルから継承した複数の値を持つプロパティの現在のレベルの設定だけが表示されることに注意してください。たとえば、ソリューションエクスプローラーでファイルが選択されている状態で C または C++ の [プロセッサの定義] プロパティを選択した場合は、ファイルレベルの定義が表示されますが、継承したプロジェクトレベルの定義は表示されません。現在のレベルと継承した値の両方を表示するには、プロパティ名の右側の列のドロップダウン矢印をクリックして、[編集] をクリックします。Visual C++ のプロジェクトモデルを使用している場合、ファイルとプロジェクトのオブジェクトに対してもこの動作が影響します。つまり、ファイルレベルでプロパティの値をクエリすると、その同じプロパティのプロジェクトレベルでの値は取得できません。そのプロパティのプロジェクトレベルでの値は、明示的に取得する必要があります。また、継承したプロパティの値の一部はスタイルシートから取得したもので、プログラムではアクセスできません。