QQmlFileSelector Class

QML ファイルの読み込みにQFileSelector を適用するためのクラス。詳細...

Header: #include <QQmlFileSelector>
CMake: find_package(Qt6 REQUIRED COMPONENTS Qml)
target_link_libraries(mytarget PRIVATE Qt6::Qml)
qmake: QT += qml
Inherits: QObject

パブリック関数

QQmlFileSelector(QQmlEngine *engine, QObject *parent = nullptr)
virtual ~QQmlFileSelector() override
QFileSelector *selector() const
void setExtraSelectors(const QStringList &strings)
void setSelector(QFileSelector *selector)

詳しい説明

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タイプにComponent.qmlを使用します。しかし、unixプラットフォームでは、unixセレクタが存在し、+unix/Component.qmlバージョンが代わりに使用されます。これはComponent.qmlと+unix/Component.qmlを入れ替えたようなものなので、Component.qmlを使用する場合、どのバージョンが選択されたかに応じてパスを変更する必要はないことに注意してください。

たとえば、"asset.png "ファイルのパスを渡すには、main.qml、Component.qml、+linux/Component.qmlのすべてで "asset.png "とだけ参照します。Macプラットフォームでは、すべてのケースで+mac/asset.pngに置き換えられます。

利用可能なセレクタの一覧はQFileSelector を参照してください。

お使いのプ ラ ッ ト フ ォームで も 、 利用可能な追加のセ レ ク ト リ が提供 さ れ る 場合があ り ます。QFileSelector で指定されているように、セレクションに使用されるディレクトリは '+' 文字で始まる必要があります。

新しい QQmlFileSelector がエンジンに設定されると、古いものは置き換えられます。

メンバー関数ドキュメント

[explicit] QQmlFileSelector::QQmlFileSelector(QQmlEngine *engine, QObject *parent = nullptr)

新しい QQmlFileSelector を作成します。親オブジェクトはparent で、自身のQFileSelector を含みます。engine は、ファイルセレクタを適用したいQQmlEngine です。また、QQmlFileSelector の所有権も取得します。

[override virtual noexcept] QQmlFileSelector::~QQmlFileSelector()

QQmlFileSelector オブジェクトを破棄します。

[noexcept] QFileSelector *QQmlFileSelector::selector() const

QQmlFileSelector で使用されているQFileSelector インスタンスを返します。

setSelector()も参照してください

void QQmlFileSelector::setExtraSelectors(const QStringList &strings)

strings に含まれる追加セレクタを、現在使用しているQFileSelector に追加します。独自のQFileSelector インスタンスを作成する手間を省くために、追加のセレクタが必要な場合に使用します。

void QQmlFileSelector::setSelector(QFileSelector *selector)

QQmlFileSelector が使用するQFileSelector インスタンスをselector に設定する。QQmlFileSelector は新しいQFileSelector の所有権を持たない。QQmlFileSelector をリセットして内部のQFileSelector インスタンスを使用するには、 setSelector(nullptr) を呼び出す。

selector()も参照してください

本ドキュメントに含まれる文書の著作権は、それぞれの所有者に帰属します 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。