C

ModuleFiles.fileSelector

字符串列表,指定选择模块文件时使用的变体。

描述

您可以在项目有大量具有相同名称和目的的文件,但其内容根据所选设备的特性(屏幕大小、平台、语言等)而变化,且项目为特定的一组特性使用每个文件的情况下使用 fileSelector 属性。

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

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

  • 在文件节点(QmlFilesImageFilesFontFiles ModuleFilesTranslationFiles)中通过 "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:
//      src/modules/+device1/display.qmlproject
//      src/modules/+device2/display.qmlproject

// Picks src/modules/+device1/display.qmlproject
ModuleFiles {
    fileSelector: ["device1"]
    files: ["src/modules/display.qmlproject"]
}

此属性是在 QmlProject API 1.3 中引入的。

在特定Qt许可证下可用。
了解更多。