VCCLCompilerTool インターフェイス

[アーティクル]
05/16/2015

VCCLCompilerTool オブジェクトは、C++ コンパイラオプションの機能を公開します。コンパイラオプションの詳細については、「コンパイラオプション」を参照してください。

名前空間: Microsoft.VisualStudio.VCProjectEngine
アセンブリ: Microsoft.VisualStudio.VCProjectEngine (Microsoft.VisualStudio.VCProjectEngine.dll 内)

構文

'宣言
<GuidAttribute("3D6193F2-8B5D-4B0A-967F-7D163D918848")> _
Public Interface VCCLCompilerTool

[GuidAttribute("3D6193F2-8B5D-4B0A-967F-7D163D918848")]
public interface VCCLCompilerTool

[GuidAttribute(L"3D6193F2-8B5D-4B0A-967F-7D163D918848")]
public interface class VCCLCompilerTool

[<GuidAttribute("3D6193F2-8B5D-4B0A-967F-7D163D918848")>]
type VCCLCompilerTool =  interface end

public interface VCCLCompilerTool

VCCLCompilerTool 型で公開されるメンバーは以下のとおりです。

プロパティ

	名前	説明
	AdditionalIncludeDirectories	インクルードパスに追加する 1 つ以上のディレクトリを取得または設定します。AdditionalIncludeDirectories は、コンパイラの /I (追加インクルードディレクトリ) オプション、MIDL コンパイラの [全般] ([MIDL] プロパティページ) オプション、およびリソースコンパイラの [リソース] プロパティページオプションの機能を公開します。
	AdditionalOptions	コマンドラインの末尾、ファイル名の直前に追加するオプションを取得または設定します。たとえば、あるオプションがオブジェクトモデルでサポートされない場合に指定します。
	AdditionalUsingDirectories	#using ディレクティブ (C++) ディレクティブに渡されたファイル参照を解決するために検索するディレクトリを取得または設定します。AdditionalUsingDirectories は、コンパイラの /AI (メタデータディレクトリの指定) オプションの機能を公開します。
	AssemblerListingLocation	ASM リスティングファイルの相対パスと名前の両方またはいずれかを取得または設定します。AssemblerListingLocation は、コンパイラの /Fa オプションの機能を公開します。
	AssemblerOutput	アセンブリ言語の出力ファイルの内容を取得または設定します。AssemblerOutput は、コンパイラの /FA、/Fa (リスティングファイル) オプションの機能を公開します。
	BasicRuntimeChecks	完全なランタイムエラーチェック /RTC (ランタイムエラーチェック)) を実行するかどうか、実行時にスタックフレームの有効性をチェックするかどうか (/RTC (ランタイムエラーチェック))、および実行時に初期化前の状態に戻された変数をチェックするかどうか (/RTC (ランタイムエラーチェック)) を示す値を取得または設定します。
	BrowseInformation	.bsc ファイルで情報を参照します。のレベルを指定します。BrowseInformation は、コンパイラの /FR、/Fr (.sbr ファイルの作成) オプションの機能を公開します。
	BrowseInformationFile	ブラウザー情報ファイルのオプションの名前を取得または設定します。BrowseInformationFile は、コンパイラの /FR、/Fr (.sbr ファイルの作成) オプションの機能を公開します。
	BufferSecurityCheck	バッファーオーバーランをチェックするかどうかを示す値を取得または設定します。BufferSecurityCheck は、コンパイラの /GS (バッファーのセキュリティチェック) オプションの機能を公開します。
	CallingConvention	アプリケーションの既定の呼び出し規約を取得または設定します。CallingConvention は、コンパイラの /Gd、/Gr、/Gv、/Gz (呼び出し規約) オプションの機能を公開します。
	CompileAs	.c ファイルおよび .cpp ファイルのコンパイル言語オプションを選択します。CompileAs は、コンパイラの /Tc、/Tp、/TC、/TP (ソースファイルタイプの指定) オプションの機能を公開します。
	CompileAsManaged	コンパイラオプションを示す値を取得または設定します。
	CompileOnly	リンクなしでコンパイルするかどうかを示す値を取得または設定します。
	DebugInformationFormat	コンパイラによって生成されるデバッグ情報の種類を取得または設定します。DebugInformationFormat は、コンパイラの /Z7、/Zi、/ZI (デバッグ情報の形式) オプションの機能を公開します。
	DefaultCharIsUnsigned	既定の char 型が符号なしかどうかを取得または設定します。DefaultCharIsUnsigned は、コンパイラの /J (既定の char 型の unsigned への変更) オプションの機能を公開します。
	Detect64BitPortabilityProblems	コンパイラで 64 ビット移植性の問題をチェックするかどうかを示す値を取得または設定します。Detect64BitPortabilityProblems は、コンパイラの /Wp64 (64 ビット移植性の問題の検出) オプションの機能を公開します。
	DisableLanguageExtensions	言語拡張を表示しないかどうかを示す値を取得または設定します。DisableLanguageExtensions は、コンパイラの /Za、/Ze (言語拡張機能の無効化) オプションの機能を公開します。
	DisableSpecificWarnings	特定の警告番号を無効にする値を取得または設定します。セミコロン (;) で区切ったリスト形式で数字を指定します。DisableSpecificWarnings は、コンパイラの /w、/Wn、/WX、/Wall、/wln、/wdn、/wen、/won (警告レベル) オプションの機能を公開します。
	EnableEnhancedInstructionSet	IA-32 に対応する SSE や SSE2 の機能強化などの拡張命令セットをサポートするプロセッサの命令の使用を有効にする値を取得または設定します。EnableEnhancedInstructionSet は、コンパイラの /ARCH オプションの機能を公開します。
	EnableFiberSafeOptimizations	ファイバーまたはスレッドローカルストレージアクセスを使用するときに、メモリ空間の最適化を有効にする値を取得または設定します。EnableFiberSafeOptimizations は、コンパイラの /GT (スレッドローカルストレージを使用したファイバー保護のサポート) オプションの機能を公開します。
	EnableFunctionLevelLinking	関数レベルのリンクを有効にすることを示す値を取得または設定します。EnableFunctionLevelLinking は、コンパイラの /Gy (関数レベルのリンクの有効化) オプションの機能を公開します。
	EnableIntrinsicFunctions	組み込み関数を使用するかどうかを示す値を取得または設定します。組込み関数でコードは迅速に生成できますが、サイズが大きくなることがあります。EnableIntrinsicFunctions は、コンパイラの /Oi (組み込み関数の生成) オプションの機能を公開します。
	EnablePREfast	ネイティブコード分析を有効にするかどうかを取得または設定します。
	ErrorReporting	コンパイラのエラーレポートを取得または設定します。
	ExceptionHandling	スローされた例外によって発生したスタックのアンワインドで、自動オブジェクトのデストラクターを呼び出すときに使用する値を取得または設定します。ExceptionHandling は、コンパイラの /EH (例外処理モデル) オプションの機能を公開します。
	ExecutionBucket	インフラストラクチャ。マイクロソフト内部でのみ使用します。
	ExpandAttributedSource	ソースファイルに拡張された属性を挿入して、リスティングファイルを作成するかどうかを示す値を取得または設定します。ExpandAttributedSource は、コンパイラの /Fx (挿入されたコードのマージ) オプションの機能を公開します。
	FavorSizeOrSpeed	コードサイズとコード速度のどちらを優先するかを示す値を取得または設定します。FavorSizeOrSpeed は、コンパイラの /Os、/Ot (実行可能ファイルのサイズの優先、実行速度の優先) オプションの機能を公開します。
	FloatingPointExceptions	ユーザー定義の浮動小数点の例外処理を有効にするかどうかを設定または取得します。
	floatingPointModel	浮動小数点モデルを設定または取得します。
	ForceConformanceInForLoopScope	For ループで、強制的にコンパイラをローカルスコープに準拠させるかどうかを示す値を取得または設定します。ForceConformanceInForLoopScope は、コンパイラの /Zc:forScope (for ループのスコープの強制準拠) オプションの機能を公開します。
	ForcedIncludeFiles	1 つ以上の強制インクルードファイルを指定する値を取得または設定します。ForcedIncludeFiles は、コンパイラの /FI (強制インクルードファイルの名前の指定) オプションの機能を公開します。
	ForcedUsingFiles	#using ディレクティブ (C++) ディレクティブに渡された場合と同じ方法でファイル名の使用を強制します。ForcedUsingFiles は、コンパイラの /FU (強制 #using ファイルの名前の指定) オプションの機能を公開します。
	FullIncludePath	ビルドに含まれるすべてのディレクトリ、/l で指定されたディレクトリの連結、および [VC++ Directories] ダイアログボックスで指定したディレクトリのリストを取得します。これらのディレクトリ内にあるマクロも評価されます。
	GeneratePreprocessedFile	この構成のプリプロセスオプションを取得または設定します。GeneratePreprocessedFile は、コンパイラの /EP (#line ディレクティブを挿入しない stdout へのプリプロセス) および /P (プリプロセス出力のファイルへの書き込み) オプションの機能を公開します。
	GenerateXMLDocumentationFiles	XML ドキュメントファイルを生成するかどうかを設定または取得します。
	IgnoreStandardIncludePath	標準のインクルードパスを無視するかどうかを示す値を取得または設定します。IgnoreStandardIncludePath は、コンパイラの /X (標準インクルードパスの無視) オプション、MIDL コンパイラの [全般] ([MIDL] プロパティページ) オプション、およびリソースコンパイラの [リソース] プロパティページオプションの機能を公開します。
	InlineFunctionExpansion	ビルドのインライン関数の拡張レベルを取得または設定します。InlineFunctionExpansion は、コンパイラの /Ob (関数のインライン展開) オプションの機能を公開します。
	KeepComments	ソースコードから除去されたコメントを非表示にするかどうかを示す値を取得または設定します。KeepComments は、コンパイラの /C (プリプロセス時のコメントの保持) オプションの機能を公開します。
	MinimalRebuild	C++ クラス定義の変更を検出し、影響を受けるソースファイルを再コンパイルするかどうかを示す値を取得または設定します。MinimalRebuild は、コンパイラの /Gm (簡易リビルドの有効化) オプションの機能を公開します。
	ObjectFile	既定のオブジェクトファイル名をオーバーライドするファイル名を取得または設定します。ObjectFile は、コンパイラの /Fo (オブジェクトファイルの名前の指定) オプションの機能を公開します。
	OmitDefaultLibName	既定のライブラリ名を省略するかどうかを取得または設定します。
	OmitFramePointers	フレームポインターを非表示にするかどうかを示す値を取得または設定します。OmitFramePointers は、コンパイラの /Oy (フレームポインターの省略) オプションの機能を公開します。
	OpenMP	OpenMP を有効にするかどうかを取得または設定します。
	Optimization	コード最適化のオプションを取得または設定します。Optimization は、コンパイラの /Od (無効 (デバッグ))、/O1、/O2 (プログラムサイズ、実行速度) および /Ox (最大限の最適化) オプションの機能を公開します。
	PrecompiledHeaderFile	生成するプリコンパイル済みヘッダーファイルのパスと名前の両方またはいずれかを取得または設定します。PrecompiledHeaderFile は、コンパイラの /Fp (.pch ファイルの名前の指定) オプションの機能を公開します。
	PrecompiledHeaderThrough	プリコンパイル済みヘッダーファイルの作成時または使用時に用いるヘッダーファイル名を取得または設定します。PrecompiledHeaderThrough は、コンパイラの /Yc (プリコンパイル済みヘッダーファイルの作成) および /Yu (プリコンパイル済みヘッダーファイルの使用) オプションの機能を公開します。
	PreprocessorDefinitions	1 つ以上のプリプロセッサ定義を取得または設定します。PreprocessorDefinitions は、コンパイラの /D (プリプロセッサの定義) オプション、MIDL コンパイラの [全般] ([MIDL] プロパティページ) オプション、およびリソースコンパイラの [リソース] プロパティページオプションの機能を公開します。
	ProgramDataBaseFileName	コンパイラで生成された .pdb ファイルの名前と、必須のコンパイラで生成された .idb ファイルの基本名を取得または設定します。ProgramDataBaseFileName は、コンパイラの /Fd (プログラムデータベースファイル名) オプションの機能を公開します。
	RuntimeLibrary	リンク用のランタイムライブラリを取得または設定します。RuntimeLibrary は、コンパイラの /MD、/MT、/LD (ランタイムライブラリの使用) オプションの機能を公開します。
	RuntimeTypeInfo	実行時に C++ オブジェクト型をチェックする場合、コードを追加するかどうかを示す値を取得または設定します (実行時の型情報)。RuntimeTypeInfo は、コンパイラの /GR (ランタイム型情報の有効化) オプションの機能を公開します。
	ShowIncludes	コンパイラの出力でインクルードファイルの一覧を生成するかどうかを示す値を取得または設定します。ShowIncludes は、コンパイラの /showIncludes (インクルードファイル一覧) オプションの機能を公開します。
	SmallerTypeCheck	より小さな型に変換するときのチェックを有効にするかどうかを示す値を取得または設定します。SmallerTypeCheck は、コンパイラの /RTC (ランタイムエラーチェック) オプションの機能を公開します。
	StringPooling	より小さなコンパイルコードを生成するために、読み取り専用の文字列プールを有効にするかどうかを示す値を取得または設定します。StringPooling は、コンパイラの /GF (同一文字列の削除) オプションの機能を公開します。
	StructMemberAlignment	構造体メンバーを整列させる 1、2、4、8、または 16 バイトの境界を指定します。StructMemberAlignment は、C++ コンパイラの /Zp (構造体メンバーの配置) オプションおよび MIDL コンパイラの [詳細] ([MIDL] プロパティページ) オプションの機能を公開します。
	SuppressStartupBanner	著作権情報および情報メッセージを表示しません。
	ToolKind	ツールの種類の名前を取得します。
	toolName	指定したツールの名前を取得します。
	ToolPath	指定したツールのパスを取得します。
	TreatWChar_tAsBuiltInType	wchar_t を組み込み型として扱うかどうかを示す値を取得または設定します。TreatWChar_tAsBuiltInType は、コンパイラの /Zc:wchar_t (wchar_t をネイティブ型として認識) オプションの機能を公開します。
	UndefineAllPreprocessorDefinitions	事前に定義されたプリプロセッサ値を未定義にするかどうかを示す値を取得または設定します。UndefineAllPreprocessorDefinitions は、コンパイラの /U、/u (定義済みマクロシンボルの未定義化) オプションの機能を公開します。
	UndefinePreprocessorDefinitions	1 つ以上のプリプロセッサを未定義に指定する値を取得または設定します。UndefinePreprocessorDefinitions は、C++ コンパイラの /U、/u (定義済みマクロシンボルの未定義化) オプションおよび MIDL コンパイラの [詳細] ([MIDL] プロパティページ) オプションの機能を公開します。
	UseFullPaths	完全パスを使用するかどうかを取得または設定します。
	UsePrecompiledHeader	ビルド時にプリコンパイル済みヘッダーの作成または使用を有効にする値を取得または設定します。UsePrecompiledHeader は、コンパイラの /Yc (プリコンパイル済みヘッダーファイルの作成) および /Yu (プリコンパイル済みヘッダーファイルの使用) オプションの機能を公開します。
	UseUnicodeResponseFiles	コンパイラが Unicode 応答ファイルを使用しているかどうかを指定します。
	VCProjectEngine	プロジェクトエンジンへのポインターを取得します。
	WarnAsError	コンパイラですべての警告をエラーとして扱えるようにするかどうかを示す値を取得または設定します。WarnAsError は、C++ コンパイラの /w、/Wn、/WX、/Wall、/wln、/wdn、/wen、/won (警告レベル) オプションおよび MIDL コンパイラの [全般] ([MIDL] プロパティページ) オプションの機能を公開します。
	WarningLevel	コンパイラで、問題があると思われる構造をどの程度厳密にチェックするかを示す値を取得または設定します。WarningLevel は、C++ コンパイラの /w、/Wn、/WX、/Wall、/wln、/wdn、/wen、/won (警告レベル) オプションおよび MIDL コンパイラの /w、/Wn、/WX、/Wall、/wln、/wdn、/wen、/won (警告レベル) オプションの機能を公開します。
	WholeProgramOptimization	コードの生成をリンク時に行うことで、モジュール間の最適化を有効にするかどうかを示す値を取得または設定します。WholeProgramOptimization は、コンパイラの /GL (プログラム全体の最適化) オプションの機能を公開します。
	XMLDocumentationFileName	XML ドキュメントファイル名を取得または設定します。

このページのトップへ

メソッド

	名前	説明
	get_PropertyOption	インフラストラクチャ。マイクロソフト内部でのみ使用します。

このページのトップへ

解説

次の新しいコンパイラオプションが Visual Studio 2005 に追加されました。

次のコンパイラオプションが Visual Studio 2005 で削除されました。

/Op
/G6、/G7、および /GB

例

EnablePREfast プロパティおよび AdditionalOptions プロパティを使用して /analyze:WX- スイッチを設定する方法を次の例に示します。いずれのプロパティも、これを行う必要があります。/analyze:WX- を指定することは、コード分析警告が /WX を指定したコンパイルではエラーとして扱われないことを意味します。詳細については、「/analyze (コード分析)」を参照してください。

この例を実行するには、「方法 : オートメーションオブジェクトモデルのコード例をコンパイルおよび実行する」の説明に従ってコードを入力し、実行します。次に、Visual Studio の新しいインスタンスで、Visual C++ プロジェクトを読み込み、アドインマネージャーを使用してアドインをアクティブにします。

' Add reference to Microsoft.VisualStudio.VCProjectEngine.
Imports System
Imports EnvDTE
Imports EnvDTE80
Imports System.Diagnostics
Imports Microsoft.VisualStudio.VCProjectEngine
Imports System.Text

Sub EnablePREfastExample(ByVal dte As DTE2)
    Dim prj As VCProject
    Dim cfgs, tools As IVCCollection
    Dim cfg As VCConfiguration
    Dim tool As VCCLCompilerTool
    Dim sb As New StringBuilder

    prj = CType(dte.Solution.Projects.Item(1).Object, _
      Microsoft.VisualStudio.VCProjectEngine.VCProject)
    cfgs = CType(prj.Configurations, _
      Microsoft.VisualStudio.VCProjectEngine.IVCCollection)
    cfg = CType(cfgs.Item(1), _
      Microsoft.VisualStudio.VCProjectEngine.VCConfiguration)
    tool = CType(cfg.Tools("VCCLCompilerTool"), _
      Microsoft.VisualStudio.VCProjectEngine.VCCLCompilerTool)

    sb.Length = 0
    sb.Append("Current project PREfast setting: " _
      & tool.EnablePREfast & Environment.NewLine)
    sb.Append("Flag: " & tool.AdditionalOptions)
    MsgBox(sb.ToString)

    ' Toggle PREfast setting.
    If Not (tool.EnablePREfast = True) Then
        ' PREfast is not enabled. Turn it and the WX- flag on.
        tool.EnablePREfast = True
        tool.AdditionalOptions = "/analyze:WX-"
    Else
        ' Toggle the opposite.
        tool.EnablePREfast = False
        tool.AdditionalOptions = "/analyze:WX"
    End If
    sb.Length = 0
    sb.Append("New project PREfast setting: " _
      & tool.EnablePREfast & Environment.NewLine)
    sb.Append("Flag: " & tool.AdditionalOptions)
    MsgBox(sb.ToString)
End Sub

// Add references to Microsoft.VisualStudio.VCProjectEngine and 
// System.Windows.Forms.
using System;
using Extensibility;
using EnvDTE;
using EnvDTE80;
using Microsoft.VisualStudio.VCProjectEngine;
using System.Text;
using System.Windows.Forms;

public void EnablePREfastExample(DTE2 dte)
{
    try
    {
        VCProject prj;
        IVCCollection cfgs, tools;
        VCConfiguration cfg;
        VCCLCompilerTool tool;
        StringBuilder sb = new StringBuilder();

        prj = (Microsoft.VisualStudio.VCProjectEngine.VCProject)
          dte.Solution.Projects.Item(1).Object;
        cfgs = 
          (Microsoft.VisualStudio.VCProjectEngine.IVCCollection)
          prj.Configurations;
        cfg = 
          (Microsoft.VisualStudio.VCProjectEngine.VCConfiguration)
           cfgs.Item(1);
        tools = 
          (Microsoft.VisualStudio.VCProjectEngine.IVCCollection)
          cfg.Tools;
        tool = 
          (Microsoft.VisualStudio.VCProjectEngine.VCCLCompilerTool)
          tools.Item("VCCLCompilerTool");
                                
        sb.Length = 0;
        sb.Append("Current project PREfast setting: " +
          tool.EnablePREfast + Environment.NewLine);
        sb.Append("Flag: " + tool.AdditionalOptions);
        MessageBox.Show(sb.ToString());

        // Toggle PREfast setting.
        if (!(tool.EnablePREfast == true))
        {
            // PREfast is not enabled. Turn it and the WX- flag on.
            tool.EnablePREfast = true;
            tool.AdditionalOptions = "/analyze:WX-";
        }
        else
        {
            // Toggle the opposite.
            tool.EnablePREfast = false;
            tool.AdditionalOptions = "/analyze:WX";
        }
        sb.Length = 0;
        sb.Append("New project PREfast setting: " +
          tool.EnablePREfast + Environment.NewLine);
        sb.Append("Flag: " + tool.AdditionalOptions);
        MessageBox.Show(sb.ToString());
    }
    catch (System.Exception errmsg)
    {
        MessageBox.Show("ERROR! " + errmsg.Message);
    }
}

参照

その他の技術情報

Walkthrough: Using /clr:pure Features

次の方法で共有

VCCLCompilerTool インターフェイス

構文

プロパティ

メソッド

解説

例

参照

関連項目

その他の技術情報

その他のリソース