C

接口文件文件选择器

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

描述

当项目有多个具有相同名称和目的但内容根据所选设备的特征(屏幕尺寸、平台、语言等)而不同时,可以结合使用 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/headers/+ram_optimized/myoperation.h
//      src/headers/+cpu_optimized/myoperation.h

// Picks src/headers/+ram_optimized/myoperation.h
InterfaceFiles {
    fileSelector: ["ram_optimized"]
    files: ["src/headers/myoperation.h"]
}

此属性自从QmlProject API 1.3版本中引入。

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