Qt Quick Controls

Qt Quick Controls fournit un ensemble de contrôles qui peuvent être utilisés pour construire des interfaces complètes dans Qt Quick. Le module a été introduit dans Qt 5.7.

Qt Quick Controls Le module est accompagné d'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.

Construire 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 la vue d'ensemble de la construction avec CMake.

Construire 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

Construction à 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 la liste complète de Qt Quick Controls, voir QML Types.

Contrôles des boutons

AbstractButton

Type de base abstrait offrant des fonctionnalités communes aux boutons

Button

Bouton-poussoir sur lequel on peut cliquer pour exécuter une commande ou répondre à une question.

CheckBox

Bouton de contrôle qui peut être activé ou désactivé

DelayButton

Bouton de contrôle qui se déclenche lorsqu'il est maintenu enfoncé suffisamment longtemps

RadioButton

Bouton radio exclusif pouvant être activé ou désactivé

RoundButton

Bouton poussoir aux coins arrondis sur lequel l'utilisateur peut cliquer

Switch

Bouton qui peut être activé ou désactivé

ToolButton

Bouton dont l'aspect convient à une barre d'outils

Contrôles de conteneurs

ApplicationWindow

Fenêtre de premier niveau stylisée avec prise en charge d'un en-tête et d'un pied de page

Container

Type de base abstrait offrant des fonctionnalités communes aux conteneurs

Frame

Cadre visuel pour un groupe logique de contrôles

GroupBox

Cadre visuel et titre pour un groupe logique de contrôles

HorizontalHeaderView

Fournit une vue d'en-tête horizontale pour accompagner un TableView

Page

Contrôle de page stylisée avec prise en charge d'un en-tête et d'un pied de page

Pane

Fournit un arrière-plan correspondant au style et au thème de l'application

ScrollView

Vue défilante

SplitView

Présente les éléments avec un séparateur à glissière entre chaque élément

StackView

Fournit un modèle de navigation basé sur une pile

SwipeView

Permet à l'utilisateur de naviguer dans les pages en glissant latéralement.

TabBar

Permet à l'utilisateur de passer d'une vue à l'autre ou d'une sous-tâche à l'autre

ToolBar

Conteneur pour les contrôles contextuels

VerticalHeaderView

Offre une vue d'en-tête verticale pour accompagner un TableView

Contrôles délégués

CheckDelegate

Délégué d'élément avec un indicateur de vérification qui peut être activé ou désactivé

HorizontalHeaderViewDelegate

ItemDelegate

Délégué d'élément de base qui peut être utilisé dans diverses vues et contrôles

RadioDelegate

Délégué d'élément exclusif avec un indicateur radio qui peut être activé ou désactivé

SwipeDelegate

Délégué à l'item swipable

SwitchDelegate

Délégué d'élément avec un indicateur d'interrupteur qui peut être activé ou désactivé

TableViewDelegate

Un délégué qui peut être assigné à un TableView

TreeViewDelegate

Un délégué qui peut être assigné à un TreeView

VerticalHeaderViewDelegate

Contrôles d'indicateurs

BusyIndicator

Indique l'activité en arrière-plan, par exemple lorsque le contenu est en cours de chargement

PageIndicator

Indique la page active

ProgressBar

Indique la progression d'une opération

ScrollBar

Barre de défilement interactive verticale ou horizontale

ScrollIndicator

Indicateur de défilement vertical ou horizontal non interactif

Contrôles d'entrée

ComboBox

Bouton et liste déroulante combinés pour la sélection des options

Dial

Cadran circulaire que l'on fait tourner pour définir une valeur

RangeSlider

Utilisé pour sélectionner une plage de valeurs en faisant glisser deux poignées le long d'une piste

SearchField

Champ de saisie spécialisé conçu pour la fonction de recherche

Slider

Utilisé pour sélectionner une valeur en faisant glisser une poignée le long d'une piste

TextArea

Zone de saisie de texte sur plusieurs lignes

TextField

Zone de saisie de texte sur une seule ligne

Tumbler

Roue tournante d'éléments pouvant être sélectionnés

ContextMenu

Le type d'attache permet d'ouvrir un menu contextuel d'une manière adaptée à la plate-forme.

Menu

Popup qui peut être utilisé comme menu contextuel ou menu popup

MenuBar

Fournit une barre de menu de fenêtre

MenuBarItem

Présente un menu déroulant dans une barre de menu

MenuItem

Présente un élément dans un menu

Drawer

Panneau latéral pouvant être ouvert et fermé à l'aide d'un geste de balayage

StackView

Fournit un modèle de navigation basé sur une pile

SwipeView

Permet à l'utilisateur de naviguer dans les pages en effectuant un glissement latéral.

TabBar

Permet à l'utilisateur de passer d'une vue à l'autre ou d'une sous-tâche à l'autre

TabButton

Bouton dont l'aspect convient à une barre d'onglets

Dialog

Boîte de dialogue contextuelle avec des boutons standard et un titre, utilisée pour une interaction de courte durée avec l'utilisateur.

Drawer

Panneau latéral pouvant être ouvert et fermé par un geste de balayage.

Menu

Fenêtre contextuelle pouvant être utilisée comme menu contextuel ou menu contextuel

Popup

Type de base des contrôles d'interface utilisateur de type popup

ToolTip

Fournit des info-bulles pour n'importe quel contrôle

Contrôles de séparation

MenuSeparator

Sépare un groupe d'éléments d'un menu des éléments adjacents.

ToolSeparator

Sépare un groupe d'éléments d'une barre d'outils des éléments adjacents.

Versions

Qt Quick Controls La version 2.0 a été introduite dans Qt 5.7. Les versions mineures suivantes de Qt incrémentent la version d'importation des modules Qt Quick Controls d'une unité, jusqu'à Qt 5.12, où les versions d'importation correspondent à la version mineure de Qt.

Dans Qt 6, les versions majeures et mineures correspondent, et les numéros de version peuvent être omis des importations dans QML. Si la version est omise, c'est la dernière version qui sera utilisée.

Les modules expérimentaux de Qt Labs utilisent la version d'importation 1.0.

QtQtQuickQtQuick.Controls,
QtQuick.Controls.Material,
QtQuick.Controls.Universal,
QtQuick.Templates
Qt.labs.platform
5.72.72.01.0
5.82.82.11.0
5.92.92.21.0
5.102.102.31.0
5.112.112.41.0
5.122.122.121.0
6.06.06.01.0
............

Révisions

En raison de la manière dont Qt Quick Controls est mis en œuvre, les nouvelles propriétés qui sont ajoutées peuvent entrer en conflit avec les propriétés définies par l'utilisateur qui portent le même nom. Par exemple, l'extrait suivant entraînera une erreur :

import QtQuick.Controls 2.13

ApplicationWindow {
    // ...

    ComboBox {
        anchors.centerIn: parent

        // As currentValue was added in 2.14, the versioned import above
        // should cause this property to be used, but instead an error is produced:
        // "Cannot override FINAL property"
        property int currentValue: 0
    }
}

Ces propriétés doivent être renommées pour éviter le conflit.

Le module Evolution

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 des modules qui ont été effectués pour la série Qt 6 de Qt.

Articles et guides

Exemples d'utilisation

Référence

Licence et attributions

Qt Quick Controls est disponible sous les licences commerciales de The Qt Company. En outre, il est disponible sous la Licence Publique Générale Amoindrie de GNU, version 3, ou la Licence Publique Générale de GNU, 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 :

© 2025 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.