Qt Quick Contrôles
Qt Quick Controls fournit un ensemble de contrôles qui peuvent être utilisés pour construire des interfaces complètes dans Qt Quick.
Qt Quick Controls est livré avec une sélection de styles personnalisables. Voir Styling Qt Quick Controls pour plus de détails.
Utilisation du module
API QML
Les types QML du module sont disponibles via l'importation QtQuick.Controls. Pour utiliser les types, ajoutez l'instruction d'importation suivante à votre fichier .qml :
import QtQuick.Controls
API C++
L'utilisation de l'API C++ d'un module Qt nécessite l'établissement d'un lien avec la bibliothèque du module, soit directement, soit par l'intermédiaire d'autres dépendances. Plusieurs outils de construction disposent d'un support dédié à cet effet, notamment CMake et qmake.
Construction avec CMake
Utilisez la commande find_package() pour localiser le composant de module nécessaire dans le paquetage Qt6:
find_package(Qt6 REQUIRED COMPONENTS QuickControls2)
target_link_libraries(mytarget PRIVATE Qt6::QuickControls2)Pour plus de détails, voir l'aperçu de la construction avec CMake.
Construction avec qmake
Pour configurer le module afin qu'il soit construit avec qmake, ajoutez le module comme valeur de la variable QT dans le fichier .pro du projet :
QT += quickcontrols2
Construire à partir des sources
Le module Qt Image Formats est recommandé, mais pas obligatoire. Il prend en charge le format .webp utilisé par le style Imagine.
Contrôles
Pour obtenir la liste complète des contrôles de Qt Quick, voir QML Types.
Contrôles des boutons
Type de base abstrait offrant des fonctionnalités communes aux boutons | |
Bouton-poussoir sur lequel on peut cliquer pour exécuter une commande ou répondre à une question. | |
Bouton de contrôle pouvant être activé ou désactivé | |
Bouton de contrôle qui se déclenche lorsqu'il est maintenu enfoncé suffisamment longtemps | |
Bouton radio exclusif pouvant être activé ou désactivé | |
Bouton poussoir aux coins arrondis sur lequel l'utilisateur peut cliquer | |
Bouton qui peut être activé ou désactivé | |
Bouton dont l'aspect convient à une barre d'outils |
Contrôles du conteneur
Fenêtre de premier niveau stylisée avec prise en charge d'un en-tête et d'un pied de page | |
Type de base abstrait offrant des fonctionnalités communes aux conteneurs | |
Cadre visuel pour un groupe logique de contrôles | |
Cadre visuel et titre pour un groupe logique de contrôles | |
Fournit une vue d'en-tête horizontale pour accompagner un TableView | |
Contrôle de page stylisée avec prise en charge d'un en-tête et d'un pied de page | |
Fournit un arrière-plan correspondant au style et au thème de l'application | |
Vue défilante | |
Présente les éléments avec un séparateur à glissière entre chaque élément | |
Fournit un modèle de navigation basé sur une pile | |
Permet à l'utilisateur de naviguer dans les pages en glissant latéralement. | |
Permet à l'utilisateur de passer d'une vue à l'autre ou d'une sous-tâche à l'autre | |
Conteneur pour les contrôles contextuels | |
Offre une vue d'en-tête verticale pour accompagner un TableView |
Contrôles délégués
Délégué d'élément avec un indicateur de vérification qui peut être activé ou désactivé | |
Délégué d'élément de base pouvant être utilisé dans diverses vues et contrôles | |
Délégué d'élément exclusif avec un indicateur radio qui peut être activé ou désactivé | |
Délégué à l'item swipable | |
Délégué d'élément avec un indicateur d'interrupteur qui peut être activé ou désactivé | |
Un délégué qui peut être assigné à un TableView | |
Délégué pouvant être assigné à un TreeView | |
Contrôles d'indicateur
Indique l'activité en arrière-plan, par exemple, lorsque le contenu est en cours de chargement | |
Indique la page active | |
Indique la progression d'une opération | |
Barre de défilement interactive verticale ou horizontale | |
Indicateur de défilement vertical ou horizontal non interactif |
Contrôles de saisie
Bouton et liste déroulante combinés pour la sélection d'options | |
Cadran circulaire que l'on fait tourner pour définir une valeur | |
Permet à l'utilisateur de sélectionner une valeur à partir d'un ensemble de valeurs à virgule flottante prédéfinies. | |
Utilisé pour sélectionner une plage de valeurs en faisant glisser deux poignées le long d'une piste. | |
Champ de saisie spécialisé conçu pour la fonction de recherche | |
Permet de sélectionner une valeur en faisant glisser une poignée le long d'une piste | |
Permet à l'utilisateur de sélectionner une valeur à partir d'un ensemble de valeurs prédéfinies | |
Zone de saisie de texte sur plusieurs lignes | |
Zone de saisie de texte sur une seule ligne | |
Roue tournante d'éléments pouvant être sélectionnés |
Contrôles de menu
Le type attaché permet d'ouvrir un menu contextuel d'une manière adaptée à la plate-forme. | |
Popup pouvant être utilisé comme menu contextuel ou popup | |
Fournit une barre de menu de fenêtre | |
Présente un menu déroulant dans une barre de menu | |
Présente un élément dans un menu |
Contrôles de navigation
Panneau latéral pouvant être ouvert et fermé à l'aide d'un geste de balayage | |
Fournit un modèle de navigation basé sur des piles | |
Permet à l'utilisateur de naviguer dans les pages en effectuant un glissement latéral. | |
Permet à l'utilisateur de passer d'une vue à l'autre ou d'une tâche à l'autre | |
Bouton dont l'aspect convient à une barre d'onglets |
Contrôles de fenêtre contextuelle
Boîte de dialogue contextuelle avec des boutons standard et un titre, utilisée pour une interaction de courte durée avec l'utilisateur. | |
Panneau latéral pouvant être ouvert et fermé à l'aide d'un geste de balayage. | |
Fenêtre contextuelle pouvant être utilisée comme menu contextuel ou menu contextuel | |
Type de base des contrôles d'interface utilisateur de type popup | |
Fournit des info-bulles pour n'importe quel contrôle |
Contrôles de séparation
Sépare un groupe d'éléments d'un menu des éléments adjacents. | |
Sépare un groupe d'éléments d'une barre d'outils des éléments adjacents. |
Évolution du module
Qt Quick Controls a été écrit à l'origine avec des interfaces tactiles comme objectif principal. Bien qu'il soit déjà possible de développer des interfaces de bureau, des travaux sont en cours pour fournir un aspect et une convivialité plus natifs.
Changes to Qt Quick Controls liste les changements importants dans l'API et les fonctionnalités du module qui ont été effectués pour la série Qt 6 de Qt.
Schéma de versionnement décrit le schéma de versionnement utilisé pour Qt Quick Controls.
Articles et guides
- Premiers pas
- Lignes directrices
- Style
- Icônes
- Personnalisation
- Utilisation de sélecteurs de fichiers
- Déploiement
- Fichier de configuration
- Variables d'environnement
Exemples d'utilisation
- Galerie
- Tutoriel de chat
- Éditeur de texte
- Démonstration sur les vêtements
- Exemple automobile
- Tous les exemples
Référence
Modules connexes
Licence et attributions
Qt Quick Controls est disponible sous les licences commerciales de The Qt Company. En outre, il est disponible sous la licence GNU Lesser General Public License, version 3, ou la licence GNU General Public License, version 2. Voir Qt Licensing pour plus de détails.
En outre, Qt Quick Controls contient potentiellement des modules tiers sous les licences permissives suivantes :
Licence MIT |
© 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.
