cmake/Help/prop_dir/VS_GLOBAL_SECTION_POST_section.rst

32 lines
1.3 KiB
ReStructuredText
Raw Normal View History

2014-08-03 19:52:23 +02:00
VS_GLOBAL_SECTION_POST_<section>
--------------------------------
Specify a postSolution global section in Visual Studio.
Setting a property like this generates an entry of the following form
in the solution file:
::
GlobalSection(<section>) = postSolution
<contents based on property value>
EndGlobalSection
2019-11-11 23:01:05 +01:00
The property must be set to a semicolon-separated list of ``key=value``
2014-08-03 19:52:23 +02:00
pairs. Each such pair will be transformed into an entry in the
solution global section. Whitespace around key and value is ignored.
List elements which do not contain an equal sign are skipped.
2024-11-11 15:18:55 +01:00
This property only works for :ref:`Visual Studio Generators`; it is ignored
2014-08-03 19:52:23 +02:00
on other generators. The property only applies when set on a
2019-11-11 23:01:05 +01:00
directory whose ``CMakeLists.txt`` contains a :command:`project` command.
2014-08-03 19:52:23 +02:00
2019-11-11 23:01:05 +01:00
Note that CMake generates postSolution sections ``ExtensibilityGlobals``
and ``ExtensibilityAddIns`` by default. If you set the corresponding
2014-08-03 19:52:23 +02:00
property, it will override the default section. For example, setting
2019-11-11 23:01:05 +01:00
``VS_GLOBAL_SECTION_POST_ExtensibilityGlobals`` will override the default
contents of the ``ExtensibilityGlobals`` section, while keeping
2017-07-20 19:35:53 +02:00
ExtensibilityAddIns on its default. However, CMake will always
add a ``SolutionGuid`` to the ``ExtensibilityGlobals`` section
if it is not specified explicitly.