define_property

Определить и задокументировать пользовательские свойства.

define_property(<GLOBAL | DIRECTORY | TARGET | SOURCE |
                 TEST | VARIABLE | CACHED_VARIABLE>
                 PROPERTY <name> [INHERITED]
                 BRIEF_DOCS <brief-doc> [docs...]
                 FULL_DOCS <full-doc> [docs...])

Определяет одно свойство в области видимости для использования с командами set_property() и get_property(). Это в первую очередь полезно для связывания документации с именами свойств, которые могут быть получены с помощью команды get_property(). Первый аргумент определяет тип области видимости, в которой должно использоваться свойство. Он должен быть одним из следующих:

GLOBAL    = associated with the global namespace
DIRECTORY = associated with one directory
TARGET    = associated with one target
SOURCE    = associated with one source file
TEST      = associated with a test named with add_test
VARIABLE  = documents a CMake language variable
CACHED_VARIABLE = documents a CMake cache variable

Обратите внимание, что в отличие от set_property() и get_property(), не требуется указывать фактическую область видимости; важен только тип области видимости.

Обязательный параметр PROPERTY сразу же следует за именем определяемого свойства.

Если параметр INHERITED присутствует, то команда get_property() будет переходить к следующей более широкой области видимости, когда запрошенное свойство не задано в области видимости, указанной для команды. DIRECTORY цепочки областей видимости к GLOBAL. TARGET, SOURCE, и TEST цепочки к DIRECTORY.

Параметры BRIEF_DOCS и FULL_DOCS следуют за строками, которые будут ассоциированы со свойством в качестве краткого и полного описания. Соответствующие параметры команды get_property() будут извлекать документацию.