QQmlFileSelector Class
Una clase para aplicar un QFileSelector a la carga de archivos QML. Más...
| Cabecera: | #include <QQmlFileSelector> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Qml)target_link_libraries(mytarget PRIVATE Qt6::Qml) |
| qmake: | QT += qml |
| Hereda: | 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 archivos y activos qml.
Se utiliza de la siguiente manera:
QQmlEngine engine; QQmlFileSelector* selector = new QQmlFileSelector(&engine);
A continuación, puede intercambiar los archivos de esta manera:
main.qml Component.qml asset.png +unix/Component.qml +mac/asset.png
En este ejemplo, main.qml normalmente usará Component.qml para el tipo Componente. Sin embargo, en una plataforma unix, el selector unix estará presente y la versión +unix/Component.qml se utilizará en su lugar. Tenga en cuenta que esto actúa como el intercambio de Component.qml con +unix/Component.qml, por lo que cuando se utiliza Component.qml no debería ser necesario alterar las rutas en función de la versión que se ha seleccionado.
Por ejemplo, para pasar la ruta del archivo "asset.png" se referirá a él como "asset.png" en main.qml, Component.qml y +linux/Component.qml. Se sustituirá por +mac/asset.png en plataformas Mac en todos los casos.
Para obtener una lista de los selectores disponibles, consulte QFileSelector.
Su plataforma también puede proporcionarle selectores adicionales. Como se especifica en QFileSelector, los directorios utilizados para la selección deben comenzar con un carácter '+', por lo que no activará accidentalmente esta función a menos que tenga directorios con tales nombres dentro de su proyecto.
Si se establece un nuevo QQmlFileSelector en el motor, el antiguo será reemplazado.
Documentación de las funciones miembro
[explicit] QQmlFileSelector::QQmlFileSelector(QQmlEngine *engine, QObject *parent = nullptr)
Crea un nuevo QQmlFileSelector con el objeto padre parent, que incluye su propio QFileSelector. engine es el QQmlEngine al que desea aplicar los selectores de archivo. También tomará la propiedad del QQmlFileSelector.
[override virtual noexcept] QQmlFileSelector::~QQmlFileSelector()
Destruye el objeto QQmlFileSelector.
[noexcept] QFileSelector *QQmlFileSelector::selector() const
Devuelve la instancia QFileSelector utilizada por QQmlFileSelector.
Véase también setSelector().
void QQmlFileSelector::setExtraSelectors(const QStringList &strings)
Añade selectores extra contenidos en strings al actual QFileSelector que se está utilizando. Utilícelo cuando sólo necesite selectores adicionales para evitar tener que crear su propia instancia de QFileSelector.
void QQmlFileSelector::setSelector(QFileSelector *selector)
Establece la instancia QFileSelector para que la utilice QQmlFileSelector a selector. QQmlFileSelector no se apropia de la nueva QFileSelector. Para que QQmlFileSelector vuelva a utilizar su instancia interna QFileSelector, llame 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.