set_property | |
------------ | |
Set a named property in a given scope. | |
:: | |
set_property(<GLOBAL | | |
DIRECTORY [dir] | | |
TARGET [target1 [target2 ...]] | | |
SOURCE [src1 [src2 ...]] | | |
INSTALL [file1 [file2 ...]] | | |
TEST [test1 [test2 ...]] | | |
CACHE [entry1 [entry2 ...]]> | |
[APPEND] [APPEND_STRING] | |
PROPERTY <name> [value1 [value2 ...]]) | |
Set one property on zero or more objects of a scope. The first | |
argument determines the scope in which the property is set. It must | |
be one of the following: | |
``GLOBAL`` | |
Scope is unique and does not accept a name. | |
``DIRECTORY`` | |
Scope defaults to the current directory but another | |
directory (already processed by CMake) may be named by full or | |
relative path. | |
``TARGET`` | |
Scope may name zero or more existing targets. | |
``SOURCE`` | |
Scope may name zero or more source files. Note that source | |
file properties are visible only to targets added in the same | |
directory (CMakeLists.txt). | |
``INSTALL`` | |
Scope may name zero or more installed file paths. | |
These are made available to CPack to influence deployment. | |
Both the property key and value may use generator expressions. | |
Specific properties may apply to installed files and/or directories. | |
Path components have to be separated by forward slashes, | |
must be normalized and are case sensitive. | |
To reference the installation prefix itself with a relative path use ".". | |
Currently installed file properties are only defined for | |
the WIX generator where the given paths are relative | |
to the installation prefix. | |
``TEST`` | |
Scope may name zero or more existing tests. | |
``CACHE`` | |
Scope must name zero or more cache existing entries. | |
The required ``PROPERTY`` option is immediately followed by the name of | |
the property to set. Remaining arguments are used to compose the | |
property value in the form of a semicolon-separated list. If the | |
``APPEND`` option is given the list is appended to any existing property | |
value. If the ``APPEND_STRING`` option is given the string is append to any | |
existing property value as string, i.e. it results in a longer string | |
and not a list of strings. | |
See the :manual:`cmake-properties(7)` manual for a list of properties | |
in each scope. |