"Fossies" - the Fresh Open Source Software Archive

Member "cmake-3.6.2-win32-x86/share/cmake-3.6/Help/command/set_property.rst" (7 Sep 2016, 2442 Bytes) of archive /windows/misc/cmake-3.6.2-win32-x86.zip:

As a special service "Fossies" has tried to format the requested source page into HTML format (assuming markdown format). Alternatively you can here view or download the uninterpreted source code file. A member file download can also be achieved by clicking within a package contents listing on the according byte size field.


Set a named property in a given scope.


set_property( [APPEND] [APPEND_STRING] PROPERTY [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.