Uso de selectores de archivos con los controles « Qt Quick »
File selectors ofrecen una forma cómoda de seleccionar variantes de archivo. Qt ofrece el nombre de la plataforma y la configuración regional como selectores integrados. Los controles « Qt Quick » amplían los selectores integrados con el nombre (en mayúsculas) del estilo con el que se está ejecutando una aplicación.
Al utilizar selectores de archivos, se pueden aplicar ajustes específicos de estilo sin crear una dependencia rígida con respecto a un estilo. De entre las variantes de archivo disponibles, el motor QML solo carga el archivo QML seleccionado. Cada variante de archivo puede adoptar el contexto, es decir, un estilo específico. Esto suele conllevar cierta duplicación de código, pero, por otro lado, elimina la mencionada dependencia rígida del estilo y da lugar a un código QML más sencillo y eficiente.
El siguiente ejemplo muestra un botón redondeado personalizado que tiene una sombra proyectada con estilo en el estilo «Material» y un aspecto plano en otros estilos. Los archivos están organizados de tal manera que la versión «Material» de CustomButton.qml se coloca en un subdirectorio llamado +Material.
:/main.qml
:/CustomButton.qml
:/+Material/CustomButton.qmlPor defecto, main.qml utilizará CustomButton.qml para el tipo CustomButton. Sin embargo, cuando la aplicación se ejecute con el estilo Material, estará presente el selector Material y se utilizará en su lugar la versión +Material/CustomButton.qml.
// main.qml
import QtQuick
import QtQuick.Controls
ApplicationWindow {
id: window
visible: true
CustomButton {
text: "Button"
anchors.centerIn: parent
}
}La implementación básica del botón personalizado es un sencillo botón plano redondeado.
// CustomButton.qml
import QtQuick
import QtQuick.Controls
Button {
id: control
background: Rectangle {
radius: width / 2
implicitWidth: 36
implicitHeight: 36
color: control.pressed ? "#ccc" : "#eee"
}
}La implementación del botón personalizado con el estilo Material importa dicho estilo, solicita un tema oscuro para obtener texto claro y crea una sombra paralela para el fondo.
// +Material/CustomButton.qml
import QtQuick
import QtQuick.Effects
import QtQuick.Controls
import QtQuick.Controls.Material
Button {
id: control
Material.theme: Material.Dark
background: Rectangle {
implicitWidth: 48
implicitHeight: 48
color: Material.accentColor
radius: width / 2
layer.enabled: control.enabled
layer.effect: MultiEffect {
shadowEnabled: true
shadowHorizontalOffset: 3
shadowVerticalOffset: 3
shadowColor: Material.dropShadowColor
shadowBlur: control.pressed ? 0.8 : 0.4
}
}
}Nota: Se recomienda utilizar ` QQmlApplicationEngine`, que crea internamente una instancia de ` QQmlFileSelector `. Esto es todo lo que se necesita para utilizar los selectores de archivos QML.
Información relacionada
© 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.