Skip to content

Commit 694a74f

Browse files
author
mikeblome
committed
added more info to general prop page for items
1 parent b1bdd87 commit 694a74f

1 file changed

Lines changed: 35 additions & 5 deletions

File tree

Lines changed: 35 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,14 @@
11
---
22
title: "General Property Page (File)"
3-
ms.date: "11/04/2016"
3+
ms.date: "08/30/2019"
44
f1_keywords: ["VC.Project.VCFileConfiguration.ExcludedFromBuild", "VC.Project.VCFileConfiguration.Tool"]
55
ms.assetid: 26e3711e-9e7d-4e8d-bc4c-2474538efdad
66
---
77
# General Property Page (File)
88

9-
When a file is selected in **Solution Explorer**, the **General** property page under the **Configuration Properties** node contains the following properties:
9+
This topic applies to Windows projects. For non-Windows projects, see [Linux C++ Property Page Reference](../../linux/prop-pages-linux.md).
10+
11+
When you right-click on a file node **Solution Explorer**, the **General** property page under the **Configuration Properties** node opens. It contains the following properties:
1012

1113
- **Exclude From Build**
1214

@@ -16,14 +18,42 @@ When a file is selected in **Solution Explorer**, the **General** property page
1618

1719
- **Tool**
1820

19-
The tool that will be used to build this file. See [Specifying Custom Build Tools](../specifying-custom-build-tools.md) for more information.
21+
The tool that will be used to build this file. The **Item Type** specifies the tool that will be used to process the file during the build process. [Files whose extension is known to Visual Studio](/visualstudio/extensibility/visual-cpp-project-extensibility?view=vs-2019#project-items) have a default value. You can specify a custom tool here if you have a custom file type or wish to override the default tool for a known file type. See [Specifying Custom Build Tools](../specifying-custom-build-tools.md) for more information. You can also use this property page to specify that a file is not part of the build process.
22+
23+
The following illustration shows the property page for a *.cpp* file. The default **Item Type** for this kind of file is the **C/C++ Compiler** (*cl.exe*) and the property page exposes various compiler settings that can be applied to this file only.
24+
25+
![General property page for a project item](media/file-general-item-type.png "Item type choices")
26+
27+
The following table lists the default Item Types:
28+
29+
|File extension|Item Type|Default Tool|
30+
|-|-|-|
31+
|.appx|XAML Application Definition|[App packager](/windows/win32/appxpkg/make-appx-package--makeappx-exe-)|
32+
|.hlsl, .cso|HLSL Compiler|[fxc.exe](/windows/win32/direct3dtools/fxc)|
33+
|.h|C/C++ Header|[C/C++ Preprocessor](../../preprocessor/c-cpp-preprocessor-reference.md)|
34+
|n/a|Does not participate in build|n/a|
35+
|.xml, .xslt, .xsl|Xml|[XML Editor](/visualstudio/xml-tools/xml-editor)|
36+
|.resw, .resjson|PRI Resource (UWP Apps)|[MakePri.exe](/windows/uwp/app-resources/compile-resources-manually-with-makepri)|
37+
||Media (UWP)|[App packager](/windows/win32/appxpkg/make-appx-package--makeappx-exe-)|
38+
|.xsd|XML Data Generator Tool|[XML Schema Definition Tool (Xsd.exe)](/dotnet/standard/serialization/xml-schema-definition-tool-xsd-exe) (Requires .NET workload. Not included with MSVC.)|
39+
||Manifest Tool|[mt.exe](/windows/win32/sbscs/mt-exe)|
40+
|.rc|Resource|[Windows Resource Compiler (rc.exe)](/windows/win32/menurc/resource-compiler)|
41+
|.appxmanifest|App Package Manifest|[App packager](/windows/win32/appxpkg/make-appx-package--makeappx-exe-)|
42+
|.obj|Object|[C/C++ Linker (link.exe)](cl-invokes-the-linker.md)|
43+
|.ttf|Font|n/a|
44+
|.txt|Text|n/a|
45+
|n/a|Custom Build Tool|User-defined|
46+
|n/a|Copy file|n/a|
47+
|.packagelayout|App Package Layout|[App packager](/windows/win32/appxpkg/make-appx-package--makeappx-exe-)|
48+
|.resx|Compiler Managed Resource|[Resgen.exe (Resource File Generator)](/dotnet/framework/tools/resgen-exe-resource-file-generator)|
49+
|.natvis|C++ Debugger visualization file|[Natvis framework](/visualstudio/debugger/create-custom-views-of-native-objects)|
50+
|.jpg, .bmp, .ico, etc.|Image|Resource compiler based on application type.|
51+
|.cpp|C/C++ Compiler|cl.exe|
2052

2153
To programmatically access this property, see <xref:Microsoft.VisualStudio.VCProjectEngine.VCFileConfiguration.Tool%2A>.
2254

2355
For information on how to access the **General** property page under the **Configuration Properties** node, see [Set C++ compiler and build properties in Visual Studio](../working-with-project-properties.md).
2456

25-
For non-Windows projects, see [Linux C++ Property Page Reference](../../linux/prop-pages-linux.md).
26-
2757
## See also
2858

2959
[C++ project property page reference](property-pages-visual-cpp.md)

0 commit comments

Comments
 (0)