C

TranslationFiles.fileSelector

一个字符串列表,指定在挑选翻译文件时使用哪些变体。

描述

当项目有很多同名但用途相同且内容根据所选设备特性(屏幕尺寸、平台、语言等)而变化的文件时,可以使用 fileSelector 属性。而且项目会为特定的特性集使用每个文件。

qmlprojectexporter 使用它来在整个变体中保持对文件的引用。

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

  • 在文件节点(QmlFilesImageFilesFontFiles ModuleFilesTranslationFiles)中通过 "fileSelector" 属性设置
  • 使用 "fileSelector" 属性在 MCU.Config 节点中,这将适用于所有未定义 "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:
// with different translation files for each screen
//      src/translations/+main_screen/home.ts
//      src/translations/+secondary_screen/home.ts

// Picks src/translations/+main_screen/home.ts
TranslationFiles {
    fileSelector: ["main_screen"]
    files: ["src/translations/home.ts"]
}

自从

此属性在QmlProject API 1.3中被引入。

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