get_source_file_property¶
取得原始檔的屬性。
get_source_file_property(<variable> <file>
[DIRECTORY <dir> | TARGET_DIRECTORY <target>]
<property>)
從原始檔取得屬性。屬性的值會儲存在指定的 <variable>
中。如果 <file>
不是原始檔,或者找不到原始檔屬性,則 <variable>
將被設定為 NOTFOUND
。如果原始檔屬性被定義為 INHERITED
屬性 (請參閱 define_property()
),搜尋將包含相關的父作用域,如同 define_property()
命令所描述的那樣。
預設情況下,原始檔的屬性將從目前原始目錄的作用域中讀取。
Added in version 3.18: 目錄作用域可以使用以下子選項之一覆寫
DIRECTORY <dir>
原始檔屬性將從
<dir>
目錄的作用域中讀取。CMake 必須已經知道該原始目錄,可能是通過呼叫add_subdirectory()
添加它,或者<dir>
是頂層原始目錄。相對路徑被視為相對於目前原始目錄。TARGET_DIRECTORY <target>
原始檔屬性將從建立
<target>
的目錄作用域中讀取 (<target>
因此必須已經存在)。
使用 set_source_files_properties()
來設定屬性值。原始檔屬性通常控制檔案的建置方式。其中一個始終存在的屬性是 LOCATION
。
注意
GENERATED
原始檔屬性可能是全域可見的。詳情請參閱其文件。