class QQmlFileSelector#

一个用于将 QFileSelector 应用到 QML 文件加载的类。 更多

Inheritance diagram of PySide6.QtQml.QQmlFileSelector

摘要#

方法#

静态函数#

注意

本文档可能包含自动从C++翻译到Python的代码片段。我们始终欢迎对片段翻译的贡献。如果您发现翻译存在问题,也可以通过在https:/bugreports.qt.io/projects/PYSIDE上创建工单的方式来告诉我们。

详细说明#

QQmlFileSelector 将自动应用于 qml 文件和资源路径的 QFileSelector。

用法如下

QQmlEngine engine;
QQmlFileSelector* selector = new QQmlFileSelector(&engine);

然后您可以这样更换文件

main.qml
Component.qml
asset.png
+unix/Component.qml
+mac/asset.png

在这个例子中,main.qml 通常使用 Component.qml 作为 Component 类型。然而在 Unix 平台上,Unix 选择器会存在,并将使用 +unix/Component.qml 版本。请注意,这类似于用 +unix/Component.qml 替换 Component.qml,因此在使用 Component.qml 时,您不需要根据选择哪个版本来更改任何路径。

例如,为了传递“asset.png”文件路径,您在 main.qml、Component.qml 和 +linux/Component.qml 中都只需简单地调用“asset.png”。在所有情况下,它都会被替换为 Mac 平台上的 +mac/asset.png。

有关可用选择器的列表,请参阅 QFileSelector

您的平台也可能提供供您使用的额外选择器。按照 QFileSelector 的指定,用于选择的目录必须以一个加号(+)字符开始,因此除非您的项目中有以此类名称命名的目录,否则您不会意外触发此功能。

如果在引擎上设置了新的 QQmlFileSelector,则旧的一个将被替换。

__init__(engine[, parent=None])#
参数:

创建一个新的 QQmlFileSelector,其父对象为 parent,该对象包含自己的 QFileSelector。engine 是您希望应用文件选择器的 QQmlEngine。它还将获得 QQmlFileSelector 的所有权。

static get(arg__1)#
参数:

arg__1QQmlEngine

返回类型:

QQmlFileSelector

注意

此函数已过时。

设置后不应访问文件选择器。它可能正在使用中。以下有更多详细信息。

获取目标 engine 上当前活动的 QQmlFileSelector

此方法已过时。设置后不应从引擎中检索文件选择器。它可能正在使用中。

如果传递给此处的 engine 是尚未加载任何 QML 文件的 QQmlApplicationEngine,则它将被初始化。对setExtraFileSelectors()的任何后续调用都将没有效果。

另请参阅

QQmlApplicationEngine

selector()#
返回类型:

QFileSelector

返回由 QQmlFileSelector 使用的 QFileSelector 实例。

另请参阅

setSelector()

setExtraSelectors(strings)#
参数:

strings – 字符串列表

strings 中包含的额外选择器添加到当前正在使用的 QFileSelector。当只需要额外的选择器而不需要创建自己的 QFileSelector 实例时,请使用此方法。

setSelector(selector)#
参数:

selectorQFileSelector

设置 QQmlFileSelector 以使用 selector 的 QFileSelector 实例。 QQmlFileSelector 不拥有新的 QFileSelector。要重置 QQmlFileSelector 以使用其内部 QFileSelector 实例,请调用 setSelector(None).

另请参阅

selector()