Visual Studio 2008项目系统属性中的宏

Visual Studio 2008

其他版本

更新：2007 年 11 月

本节讨论如何使用 Visual C++ 项目系统中来自脚本和外接程序中的对象模型。

宏

---

宏几乎可以存在于您从对象模型中的任何对象获得的任何字符串属性中。以下为此规则的例外情况：

• 任何界面（VCPlatform、VCProject、VCFile、VCFilter、VCConfiguration、VCFileConfiguration）上的 Name 属性。

• 任何界面（VCProjectItem 以及所有派生界面）上的 ItemName 属性。

• 任何界面（VCProjectItem 以及所有派生界面）上的 Kind 属性。

• 任何界面（VCCLCompilerTool、VCResourceCompilerTool、VCMidlTool）上的 FullIncludePath 属性。

• 任何界面（所有工具）上的 ToolName 属性。

• 任何界面（所有工具）上的 ToolPath 属性。

• VCProject 界面的 ProjectDirectory 和 ProjectFile 属性。

• VCFile 界面的 Extension 属性。

• VCFilter 界面的 UniqueIdentifier、CanonicalName 和 Filter 属性。

当属性返回的值可能包含宏时，请使用范围最适合的属性容器确定它的值。属性容器按范围由窄到宽的顺序排列如下：

• VCFileConfiguration

• VCConfiguration

• VCPlatform

• VCProjectEngine

对于有关文件配置的文件或工具，属性容器将是所需配置的 VCFileConfiguration 对象。对于项目，属性容器应是所需配置的 VCConfiguration 对象。请使用范围最窄的属性容器的对象，因为所用对象的范围越宽，可以正确扩展的宏就越少。

换句话说，当您从 VCFileConfiguration 移到 VCConfiguration 对象求值时，就会失去所有 $(Input*) 宏的上下文。当您从 VCConfiguration 移到 VCProjectEngine 或 VCPlatform 对象时，对于不在系统范围内的宏就会失去上下文。

下表中的示例演示如何对各种上下文中的宏求值。当，

• 文件位于 c:\myidls\stuff.idl 中时

• 项目位于 c:\Soln\Proj\Proj.vcproj 中时

• 解决方案位于 c:\Soln\Soln.sln 中时

• 平台为 Win32 时

• 中间目录为 DebugInt 时

• 输出目录为 c:\MyOutputs 时

• 调试配置时

• 输出名称为 Game.exe 时

宏

文件配置   

ProjectConfig

VCProjectEngine 和 VCPlatform

InputDir

c:\myidls\

c:\Soln\Proj

不适用

InputName

stuff

Proj

不适用

InputPath

c:\myidls\stuff.idl

c:\Soln\Proj\Proj.vcproj

不适用

InputFileName

stuff.idl

Proj.vcproj

不适用

InputExt

.idl

.vcproj

不适用

IntDir

DebugInt

DebugInt

不适用

OutDir

c:\MyOutputs

c:\MyOutputs

不适用

ProjectDir

c:\Soln\Proj\

c:\Soln\Proj\

不适用

ProjectName

Proj

Proj

不适用

ProjectExt

.vcproj

.vcproj

不适用

TargetDir

c:\MyOutputs\

c:\MyOutputs\

不适用

TargetPath

c:\MyOutputs\Game.exe

c:\MyOutputs\Game.exe

不适用

TargetName

Game

Game

不适用

TargetFileName

Game.exe

Game.exe

不适用

TargetExt

.exe

.exe

不适用

ConfigurationName

调试

调试

不适用

RemoteMachine

在项目级别设置

在项目级别设置

不适用

PlatformName

Win32

Win32

不适用

SolutionDir

c:\Soln

c:\Soln

c:\Soln

SolutionName

Soln

Soln

Soln

SolutionPath

c:\Soln\Soln.sln

c:\Soln\Soln.sln

c:\Soln\Soln.sln

SolutionFileName

Soln.sln

Soln.sln

Soln.sln

SolutionExt

.sln

.sln

.sln

VCInstallDir

<VC install dir>\

<VC install dir>\

<VC install dir>\

VSInstallDir

<VC install dir>\

<VC install dir>\

<VC install dir>\

FrameworkDir

<COM+ dir>\

<COM+ dir>\

<COM+ dir>\

FrameworkVersion

开发环境使用的公共语言运行库版本

开发环境使用的公共语言运行库版本

开发环境使用的公共语言运行库版本

DevEnvDir

devenv.exe 的位置

devenv.exe 的位置

devenv.exe 的位置

环境宏

根据环境

根据环境

根据环境

请注意，您为计算器的源选择的内容会显著改变求值方式，尤其是与文件名密切相关的项。