C

QmlFiles.fileSelector

字符串列表，指定在选择 QML 文件时使用哪些变体。

描述

当项目有大量同名文件且用途相同，但内容因选择的设备特性（屏幕大小、平台、语言等）而异，并且项目针对一组特定特性使用每个文件时，可以使用文件选择器属性。

qmlprojectexporter 使用它来保持所有变体中文件的引用一致。

在 qmlproject 中，您可以根据以下列表以不同级别设置此属性，qmlprojectexporter 将按照相同的顺序获取选择器的值

在文件节点（QmlFiles、ImageFiles、FontFiles ModuleFiles 和 TranslationFiles）中通过 "fileSelector" 属性
在 MCU.Config 节点中使用 "fileSelector" 属性，这将应用于文件中没有 "fileSelector" 定义的所有节点。
使用 qmlprojectexporter 的 --selector 选项，您可以配置整个项目，并且 qmlprojectexporter 将选择器应用于项目中使用的所有 .qmlproject 文件（主文件和导入的模块）
最后，qmlprojectexporter 可以在项目中使用默认的 QFileSelector 选择器。

注意：可能的选择器值仅取决于项目中的文件夹名称（《QFileSelector》将名称以“+”开头的文件夹视为可选变体）

注意：可以链式使用选择器“project/+selector_one/+selector_two/resource.png”

警告：应将选择器放在资源路径的末尾。《QFileSelector》将忽略中间的任何选择器，并且仅将其视为普通文件夹。例如，“project/+wrong_selector/normal_folder/+correct_selector1/+correct_selector2/resource.png”

使用方法

此属性接受在主应用程序 .qmlproject 文件或模块 .qmlproject 文件中。它接受非空字符串列表。

代码示例：

// Project files: 2 screens with different UI
//      src/qmls/+large_screen/Welcome.qml
//      src/qmls/+small_screen/Welcome.qml

//Picks src/qmls/+large_screen/Welcome.qml
QmlFiles {
    fileSelector: ["large_screen"]
    files: ["src/qmls/Welcome.qml"]
}

自以来

此属性在QtProject API 1.3版本中引入。

QmlProject 手册

在某些Qt许可证下可用。
了解更多。