summaryrefslogtreecommitdiffstats
path: root/Help/command/set_source_files_properties.rst
blob: 8adfb9eae6884a92a2c7840ffad9c5637a5e31c8 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
set_source_files_properties
---------------------------

Source files can have properties that affect how they are built.

.. code-block:: cmake

  set_source_files_properties([file1 [file2 [...]]]
                              [<TARGET_DIRECTORY ... | DIRECTORY ...>]
                              PROPERTIES prop1 value1
                              [prop2 value2 [...]])

Sets properties associated with source files using a key/value paired
list.

Note that source file properties are by default visible only to
targets added in the same directory (``CMakeLists.txt``).

The file properties can be made visible in a different directory by specifying
one of the additional options: ``TARGET_DIRECTORY`` or ``DIRECTORY``.

``DIRECTORY`` takes a list of processed directories paths, and sets the file
properties in those directory scopes.

``TARGET_DIRECTORY`` takes a list of existing targets. The file
properties will be set in these targets' directory scopes.

See also the :command:`set_property(SOURCE)` command.

See :ref:`Source File Properties` for the list of properties known
to CMake.  Source file properties are visible only to targets added
in the same directory (``CMakeLists.txt``).