You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/ide/general-property-page-file.md
+20-18Lines changed: 20 additions & 18 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -17,21 +17,23 @@ manager: "ghogen"
17
17
ms.workload: ["cplusplus"]
18
18
---
19
19
# General Property Page (File)
20
-
When a file is selected in **Solution Explorer**, the **General** property page under the **Configuration Properties** node contains the following properties:
21
-
22
-
**Exclude From Build**
23
-
Specifies whether the file should be in the build for the current configuration.
24
-
25
-
To programmatically access this property, see <xref:Microsoft.VisualStudio.VCProjectEngine.VCFileConfiguration.ExcludedFromBuild%2A>.
26
-
27
-
**Tool**
28
-
The tool that will be used to build this file. See [Specifying Custom Build Tools](../ide/specifying-custom-build-tools.md) for more information.
29
-
30
-
To programmatically access this property, see <xref:Microsoft.VisualStudio.VCProjectEngine.VCFileConfiguration.Tool%2A>.
31
-
32
-
For information on how to access the **General** property page under the **Configuration Properties** node, see [Working with Project Properties](../ide/working-with-project-properties.md).
33
-
34
-
For non-Windows projects, see [Linux C++ Property Page Reference](../linux/prop-pages-linux.md) or [C++ Cross Platform Property Page Reference](../linux/prop-pages-linux.md).
When a file is selected in **Solution Explorer**, the **General** property page under the **Configuration Properties** node contains the following properties:
22
+
23
+
**Exclude From Build**
24
+
Specifies whether the file should be in the build for the current configuration.
25
+
26
+
To programmatically access this property, see <xref:Microsoft.VisualStudio.VCProjectEngine.VCFileConfiguration.ExcludedFromBuild%2A>.
27
+
28
+
**Tool**
29
+
The tool that will be used to build this file. See [Specifying Custom Build Tools](../ide/specifying-custom-build-tools.md) for more information.
30
+
31
+
To programmatically access this property, see <xref:Microsoft.VisualStudio.VCProjectEngine.VCFileConfiguration.Tool%2A>.
32
+
33
+
For information on how to access the **General** property page under the **Configuration Properties** node, see [Working with Project Properties](../ide/working-with-project-properties.md).
34
+
35
+
For non-Windows projects, see [Linux C++ Property Page Reference](../linux/prop-pages-linux.md)<!-- or [C++ Cross Platform Property Page Reference](../linux/prop-pages-linux.md)-->.
Command Line | Specifies a command line for the pre-build event tool to run.
@@ -27,6 +26,7 @@ Use In Build | Specifies whether this build event is excluded from the build for
27
26
Additional files to copy | Specifies additional files to copy to the remote system. Optionally the list can be provided as a local to remote mapping pairs using a syntax like this: fulllocalpath1:=fullremotepath1;fulllocalpath2:=fullremotepath2, where a local file can be copied to the specified remote location on the remote system.
28
27
29
28
## Pre-Link Event
29
+
30
30
Property | Description
31
31
--- | ---
32
32
Command Line | Specifies a command line for the pre-link event tool to run.
@@ -35,6 +35,7 @@ Use In Build | Specifies whether this build event is excluded from the build for
35
35
Additional files to copy | Specifies additional files to copy to the remote system. Optionally the list can be provided as a local to remote mapping pairs using a syntax like this: fulllocalpath1:=fullremotepath1;fulllocalpath2:=fullremotepath2, where a local file can be copied to the specified remote location on the remote system.
36
36
37
37
## Post-Build Event
38
+
38
39
Property | Description
39
40
--- | ---
40
41
Command Line | Specifies a command line for the post-build event tool to run.
@@ -43,6 +44,7 @@ Use In Build | Specifies whether this build event is excluded from the build for
43
44
Additional files to copy | Specifies additional files to copy to the remote system. Optionally the list can be provided as a local to remote mapping pairs using a syntax like this: fulllocalpath1:=fullremotepath1;fulllocalpath2:=fullremotepath2, where a local file can be copied to the specified remote location on the remote system.
44
45
45
46
## Remote Pre-Build Event
47
+
46
48
Property | Description
47
49
--- | ---
48
50
Command Line | Specifies a command line for the pre-build event tool to run on the remote system.
@@ -51,6 +53,7 @@ Use In Build | Specifies whether this build event is excluded from the build for
51
53
Additional files to copy | Specifies additional files to copy from the remote system. Optionally the list can be provided as a remote to local mapping pairs using a syntax like this: fullremotepath1:=fulllocalpath1;fullremotepath2:=fulllocalpath2, where a remote file can be copied to the specified location on the local machine.
52
54
53
55
## Remote Pre-Link Event
56
+
54
57
Property | Description
55
58
--- | ---
56
59
Command Line | Specifies a command line for the pre-link event tool to run on the remote system.
@@ -59,6 +62,7 @@ Use In Build | Specifies whether this build event is excluded from the build for
59
62
Additional files to copy | Specifies additional files to copy from the remote system. Optionally the list can be provided as a remote to local mapping pairs using a syntax like this: fullremotepath1:=fulllocalpath1;fullremotepath2:=fulllocalpath2, where a remote file can be copied to the specified location on the local machine.
60
63
61
64
## Remote Post-Build Event
65
+
62
66
Property | Description
63
67
--- | ---
64
68
Command Line | Specifies a command line for the post-build event tool to run on the remote system.
@@ -31,4 +30,4 @@ Additional Symbol Search Paths | Additional search path for debug symbols (solib
31
30
Debug Child Processes | Specifies whether to enable debugging of child processes.
32
31
Enable Python Pretty Printing | Enable pretty printing of expression values. Only supported in gdb debugging mode.
33
32
Visualization File | Default native visualization file (.natvis) containing visualization directives for SLT types. Other .natvis files that belong to the current solution will be loaded automatically.
34
-
Additional Sources File Path Map | Additional path equivalences for the debugger to use to map Windows source file names to Linux source file names. The format is "\<windows-path>=\<linux-path>;...". A source file name found under the Windows path will be referenced as if is has been found in the same relative position under the Linux path. Files found in the local project do not require additional mapping.
33
+
Additional Sources File Path Map | Additional path equivalences for the debugger to use to map Windows source file names to Linux source file names. The format is "\<windows-path>=\<linux-path>;...". A source file name found under the Windows path will be referenced as if is has been found in the same relative position under the Linux path. Files found in the local project do not require additional mapping.
Output File | The option overrides the default name and location of the program that the linker creates. (-o)
@@ -36,6 +36,7 @@ Link Timeout | Remote linking timeout, in milliseconds.
36
36
Copy Output | Specifies whether to copy the build output file from the remote system to the local machine.
37
37
38
38
## Input
39
+
39
40
Property | Description | Choices
40
41
--- | ---| ---
41
42
Ignore Specific Default Libraries | Specifies one or more names of default libraries to ignore. (--exclude-libs lib,lib)
@@ -45,21 +46,17 @@ Library Dependencies | This option allows specifying additional libraries to be
45
46
Additional Dependencies | Specifies additional items to add to the link command line.
46
47
47
48
## Debugging
49
+
48
50
Property | Description | Choices
49
51
--- | ---| ---
50
52
Debugger Symbol Information | Debugger symbol information from the output file. | **Include All**<br>**Omit Debugger Symbol Information Only**<br>**Omit All Symbol Information**<br>
51
53
Map File Name | The Map option tells the linker to create a map file with the user specified name. (-Map=)
52
54
53
55
## Advanced
56
+
54
57
Property | Description | Choices
55
58
--- | ---| ---
56
59
Mark Variables ReadOnly After Relocation | This option marks variables read-only after relocation.
57
60
Enable Immediate Function Binding | This option marks object for immediate function binding.
58
61
Do Not Require Executable Stack | This option marks output as not requiring executable stack.
59
62
Whole Archive | Whole Archive uses all code from Sources and Additional Dependencies.
0 commit comments