QQmlFileSelector Class
Una clase para aplicar un « QFileSelector » a la carga de archivos QML. Más información...
| Encabezado: | #include <QQmlFileSelector> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Qml) target_link_libraries(mytarget PRIVATE Qt6::Qml) |
| qmake: | QT += qml |
| Heredado de: | QObject |
Funciones públicas
| QQmlFileSelector(QQmlEngine *engine, QObject *parent = nullptr) | |
| virtual | ~QQmlFileSelector() override |
| QFileSelector * | selector() const |
| void | setExtraSelectors(const QStringList &strings) |
| void | setSelector(QFileSelector *selector) |
Descripción detallada
QQmlFileSelector aplicará automáticamente un « QFileSelector » a las rutas de los archivos QML y de los recursos.
Se utiliza de la siguiente manera:
QQmlEngine engine;
QQmlFileSelector* selector = new QQmlFileSelector(&engine);A continuación, puedes sustituir archivos de la siguiente manera:
main.qml
Component.qml
asset.png
+unix/Component.qml
+mac/asset.pngEn este ejemplo, main.qml utilizará normalmente Component.qml para el tipo Component. Sin embargo, en una plataforma Unix, estará presente el selector unix y se utilizará en su lugar la versión +unix/Component.qml. Ten en cuenta que esto equivale a sustituir Component.qml por +unix/Component.qml, por lo que, al utilizar Component.qml, no deberías tener que modificar ninguna ruta en función de la versión seleccionada.
Por ejemplo, para pasar la ruta del archivo «asset.png», bastaría con hacer referencia a él simplemente como «asset.png» en todo el contenido de main.qml, Component.qml y +linux/Component.qml. En todos los casos, se sustituirá por +mac/asset.png en plataformas Mac.
Para ver una lista de los selectores disponibles, consulta QFileSelector.
Es posible que su plataforma también ofrezca selectores adicionales que pueda utilizar. Tal y como se especifica en QFileSelector, los directorios utilizados para la selección deben comenzar con el carácter «+», por lo que no activará esta función accidentalmente a menos que tenga directorios con esos nombres dentro de su proyecto.
Si se establece un nuevo QQmlFileSelector en el motor, el antiguo quedará sustituido.
Documentación de las funciones de miembro
[explicit] QQmlFileSelector::QQmlFileSelector(QQmlEngine *engine, QObject *parent = nullptr)
Crea un nuevo objeto `QQmlFileSelector` con el objeto padre ` parent`, que incluye su propio ` QFileSelector`. ` engine ` es el ` QQmlEngine ` al que deseas aplicar los selectores de archivos. Además, asumirá la propiedad del `QQmlFileSelector`.
[override virtual noexcept] QQmlFileSelector::~QQmlFileSelector()
Elimina el objeto « QQmlFileSelector ».
[noexcept] QFileSelector *QQmlFileSelector::selector() const
Devuelve la instancia de ` QFileSelector ` utilizada por ` QQmlFileSelector`.
Véase también setSelector().
void QQmlFileSelector::setExtraSelectors(const QStringList &strings)
Añade los selectores adicionales que contiene strings al QFileSelector que se está utilizando actualmente. Utiliza esta opción cuando solo necesites los selectores adicionales, para evitar tener que crear tu propia instancia de QFileSelector.
void QQmlFileSelector::setSelector(QFileSelector *selector)
Establece la instancia de ` QFileSelector ` que utilizará ` QQmlFileSelector ` en ` selector`. ` QQmlFileSelector ` no asume la propiedad de la nueva instancia de ` QFileSelector`. Para restablecer ` QQmlFileSelector ` para que utilice su instancia interna de ` QFileSelector `, llama a `setSelector(nullptr)`.
Véase también selector().
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.