Share via


Property Pages (Visual C++)

 

The latest version of this topic can be found at Property Pages (Visual C++).

By using property pages, you can specify settings for Visual Studio projects. To open the Property Pages dialog box for a Visual Studio project, on the Project menu, click Properties.

You can specify project settings so that they apply all build configurations, or you can specify different project properties for each build configuration. For example, you can specify certain settings for the Release configuration and other settings for the Debug configuration.

Not all available pages are necessarily displayed in the Property Pages dialog box. Which pages are displayed depends on the file types in the project.

For more information, see Working with Project Properties.

Default Properties vs. Modified Properties

When you use the New Project dialog box to create a project, Visual Studio uses the specified project template to initialize the project properties. Therefore, the property values in the template can be thought of as default values for that project type. In other project types, the properties may have different default values.

A project property value appears in bold if it is modified. A project property can be modified for the following reasons:

  • The application wizard changes the property because it requires a different property value than the one that is specified in the project template.

  • You specify a different property value in the New Project dialog box.

  • You specify a different property value on a project property page.

Tip

To see the final set of property values that MSBuild uses to build your project, examine the preprocessor output file, which you can produce by using this command line: MSBuild /preprocess:preprocessor_output_filenameoptproject_filenameopt

Resetting Properties

When you view the Property Pages dialog box for a project and the project node is selected in Solution Explorer, for many properties, you can select inherit from parent or project defaults or modify the value another way.

When you view the Property Pages dialog box for a project and a file is selected in Solution Explorer, for many properties, you can select inherit from parent or project defaults or modify the value another way. However, if the project contains many files that have property values that differ from the project default values, the project will take longer to build.

Tip

To refresh the Property Pages dialog box so that it displays the latest selections, click Apply.

Most project defaults are system (platform) defaults. Some project defaults derive from the style sheets that are applied when you update properties in the Project Defaults section of the General configuration properties page for the project. For more information, see General Property Page (Project).

Specifying User-Defined Values

You must define the value for certain properties. A user-defined value can contain one or more alphanumeric characters or project-file macro names. Some of these properties can take only one user-defined value, but others can take a semicolon-delimited list of multiple values.

To specify a user-defined value for a property, or a list if the property can take multiple user-defined values, in the column to the right of the property name, perform one of the following actions:

  • Type the value or the list of values.

  • Click the drop-down arrow. If Edit is available, click it and then in the text box, type the value or list of values. An alternate way to specify a list is to type each value on a separate line in the text box. On the property page, the values will be displayed as a semicolon-delimited list.

    To insert a project-file macro as a value, click Macros and then double-click the macro name.

  • Click the drop-down arrow. If Browse is available, click it and then select one or more values.

For a multi-valued property, the inherit from parent or project defaults option is available when you click the drop-down arrow in the column to the right of the property name and then click Edit. By default, the option is selected.

Notice that a property page only displays the settings at the current level for a multi-valued property that inherits from another level. For example, if a file is selected in Solution Explorer and you select the C/C++ Preprocessor Definitions property, file-level definitions are displayed but inherited project-level definitions are not displayed. To view both current-level and inherited values, click the drop-down arrow in the column to the right of the property name and then click Edit. If you use the Visual C++ project model, this behavior is also in effect for the objects on files and projects. That is, when you query for the values on a property at the file level, you will not get the values for that same property at the project level. You must explicitly get the values of the property at the project level. Also, some inherited values of a property may come from a style sheet, which is not accessible programmatically.

In This Section

  1. NIB: Add Reference Search Path Dialog Box

  2. Advanced, Manifest Tool, Configuration Properties, <Projectname> Property Pages Dialog Box

  3. Command Line Property Pages

  4. Custom Build Step Property Page: General

  5. Adding references

  6. General Property Page (File)

  7. General Property Page (Project)

  8. General, Manifest Tool, Configuration Properties, <Projectname> Property Pages Dialog Box

  9. HLSL Property Pages

  10. HLSL Property Pages: Advanced

  11. HLSL Property Pages: General

  12. HLSL Property Pages: Output Files

  13. Input and Output, Manifest Tool, Configuration Properties, <Projectname> Property Pages Dialog Box

  14. Isolated COM, Manifest Tool, Configuration Properties, <Projectname> Property Pages Dialog Box

  15. Linker Property Pages

  16. Managed Resources Property Page

  17. Manifest Tool Property Pages

  18. MIDL Property Pages

  19. MIDL Property Pages: Advanced

  20. MIDL Property Pages: General

  21. MIDL Property Pages: Output

  22. NMake Property Page

  23. Resources Property Pages

  24. VC++ Directories Property Page

  25. Web References Property Page

  26. XML Data Generator Tool Property Page

  27. XML Document Generator Tool Property Pages

See Also

How to: Create and Remove Project Dependencies
How to: Create and Edit Configurations
Deploying Applications