| 12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879 |
- set_property
- ------------
- Set a named property in a given scope.
- .. code-block:: cmake
- set_property(<GLOBAL |
- DIRECTORY [<dir>] |
- TARGET [<target1> ...] |
- SOURCE [<src1> ...] |
- INSTALL [<file1> ...] |
- TEST [<test1> ...] |
- CACHE [<entry1> ...] >
- [APPEND] [APPEND_STRING]
- PROPERTY <name> [value1 ...])
- Sets 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.
- See also the :command:`set_directory_properties` command.
- ``TARGET``
- Scope may name zero or more existing targets.
- See also the :command:`set_target_properties` command.
- ``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``).
- See also the :command:`set_source_files_properties` command.
- ``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.
- See also the :command:`set_tests_properties` command.
- ``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
- appended to any existing property value as string, i.e. it results in a
- longer string and not a list of strings. When using ``APPEND`` or
- ``APPEND_STRING`` with a property defined to support ``INHERITED``
- behavior (see :command:`define_property`), no inheriting occurs when
- finding the initial value to append to. If the property is not already
- directly set in the nominated scope, the command will behave as though
- ``APPEND`` or ``APPEND_STRING`` had not been given.
- See the :manual:`cmake-properties(7)` manual for a list of properties
- in each scope.
|
