Configuration Object

Home Page (Objects)OverviewFAQReference

The Configuration object represents a set of settings to use for building a project. You can have as many configurations as ways you want to build the project.

The Configuration object has the following properties and methods:

Properties
Application Name
Configurations Parent

Methods
AddCustomBuildStep MakeCurrentSettingsDefault
AddCustomBuildStepToFile RemoveFileSettings
AddFileSettings RemoveToolSettings
AddToolSettings

Using a Dual Interface to Access This Object

This section about dual interfaces is useful for writing add-ins or automating Developer Studio across processes. This section is not applicable to writing VBScript macros.

The Configuration object implements the IConfiguration dual interface. Through this interface, add-ins can directly access the members (properties, methods, and events) of this object and can employ early binding to make calls into these members faster at run time.

Add-ins written in Visual C++ can access members of the Configuration object by using the header files in Vc98\Include\objmodel. However, if you use the Developer Studio Add-in Wizard to create an add-in, the wizard automatically includes these header files in your source code.

The following table shows the header files you need for the Configuration object:

Header file Description
bldauto.h Declares the dual interfaces.
bldguid.h Declares the GUIDs used to identify the interfaces.
blddefs.h Declares additional information needed to use the interfaces, such as error IDs and enumerated constants.

Add-ins written in Visual Basic can access members of the Configuration object by using the Visual Studio '97 Project System type library, located in Msdev98\bin\ide\devbld.pkg.

Note   In the Visual Basic References dialog box (Project menu, References command), the names of the type libraries begin with "Visual C++ 6.0" for Visual C++ version 6.0. For Visual C++ version 5.0, the names begin with "Visual Studio '97."