Qt Quick Controls QML Types

Qt Quick Controls fournit des types QML pour créer des interfaces utilisateur. Ces types QML fonctionnent en conjonction avec Qt Quick et Qt Quick Layouts.

Qt Quick Les types QML de Controls peuvent être importés dans votre application à l'aide de l'instruction d'importation suivante dans votre fichier .qml :

import QtQuick.Controls

Types QML

AbstractButton	Type de base abstrait offrant des fonctionnalités communes aux boutons
Action	Action abstraite de l'interface utilisateur
ActionGroup	Regroupe les actions
ApplicationWindow	Fenêtre de premier niveau stylisée avec prise en charge d'un en-tête et d'un pied de page
BusyIndicator	Indique une activité en arrière-plan, par exemple pendant le chargement du contenu.
Button	Bouton poussoir sur lequel on peut cliquer pour exécuter une commande ou répondre à une question
ButtonGroup	Groupe de boutons à cocher s'excluant mutuellement
Calendar	Un espace de noms de calendrier
CalendarModel	Un modèle de calendrier
CheckBox	Bouton de vérification qui peut être activé ou désactivé
CheckDelegate	Délégué d'élément avec un indicateur de vérification qui peut être activé ou désactivé
ComboBox	Bouton et liste déroulante combinés pour la sélection d'options
Container	Type de base abstrait offrant des fonctionnalités communes aux conteneurs
ContextMenu	Le type attaché permet d'ouvrir un menu contextuel d'une manière adaptée à la plate-forme.
Control	Type de base abstrait offrant des fonctionnalités communes à tous les contrôles
DayOfWeekRow	Une rangée de noms pour les jours de la semaine
DelayButton	Bouton de contrôle qui se déclenche lorsqu'il est maintenu enfoncé suffisamment longtemps
Dial	Cadran circulaire que l'on fait tourner pour définir une valeur
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
DialogButtonBox	Boîte à boutons utilisée dans les boîtes de dialogue
DoubleSpinBox	Permet à l'utilisateur de choisir parmi un ensemble de valeurs à virgule flottante prédéfinies.
Drawer	Panneau latéral qui peut être ouvert et fermé par un geste de balayage.
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
HorizontalHeaderViewDelegate
ItemDelegate	Délégué d'élément de base pouvant être utilisé dans diverses vues et contrôles
Label	Étiquette de texte stylisée avec police héritée
Menu	Popup pouvant être utilisé comme menu contextuel ou menu contextuel
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
MenuSeparator	Sépare un groupe d'éléments d'un menu des éléments adjacents
MonthGrid	Une grille de jours pour un mois calendaire
Overlay	Une fenêtre superposée pour les fenêtres contextuelles
Page	Contrôle de page stylisé avec prise en charge d'un en-tête et d'un pied de page
PageIndicator	Indique la page active
Pane	Fournit un arrière-plan correspondant au style et au thème de l'application
Popup	Type de base des contrôles d'interface utilisateur de type popup
ProgressBar	Indique la progression d'une opération
RadioButton	Bouton radio exclusif pouvant être activé ou désactivé
RadioDelegate	Délégué d'élément exclusif avec un indicateur radio qui peut être activé ou désactivé
RangeSlider	Utilisé pour sélectionner une plage de valeurs en faisant glisser deux poignées le long d'une piste
RoundButton	Bouton-poussoir à coins arrondis sur lequel l'utilisateur peut cliquer
ScrollBar	Barre de défilement interactive verticale ou horizontale
ScrollIndicator	Indicateur de défilement vertical ou horizontal non interactif
ScrollView	Vue défilante
SearchField	Champ de saisie spécialisé conçu pour être utilisé dans le cadre d'une fonction de recherche
SelectionRectangle	Utilisé pour sélectionner les cellules d'un tableau à l'intérieur d'un TableView
Slider	Utilisé pour sélectionner une valeur en faisant glisser une poignée le long d'une piste
SpinBox	Permet à l'utilisateur de sélectionner une valeur à partir d'un ensemble de valeurs prédéfinies
SplitHandle	Fournit des propriétés attachées pour les poignées SplitView
SplitView	Dispose des éléments avec un séparateur glissant entre chaque élément
StackView	Fournit un modèle de navigation basé sur une pile
SwipeDelegate	Délégué d'élément glissant
SwipeView	Permet à l'utilisateur de naviguer dans les pages en glissant latéralement.
Switch	Bouton pouvant être activé ou désactivé
SwitchDelegate	Délégué d'élément avec un indicateur de commutation qui peut être activé ou désactivé
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
TableViewDelegate	Délégué pouvant être affecté à un TableView
TextArea	Zone de saisie de texte sur plusieurs lignes
TextField	Zone de saisie de texte sur une seule ligne
ToolBar	Conteneur pour les contrôles contextuels
ToolButton	Bouton dont l'aspect convient à une barre d'outils
ToolSeparator	Sépare un groupe d'éléments d'une barre d'outils des éléments adjacents.
ToolTip	Fournit des info-bulles pour n'importe quel contrôle
TreeViewDelegate	Délégué pouvant être affecté à un TreeView
Tumbler	Roue tournante d'éléments pouvant être sélectionnés
VerticalHeaderView	Offre une vue d'en-tête verticale pour accompagner un TableView
VerticalHeaderViewDelegate
WeekNumberColumn	Une colonne de numéros de semaine

Utilisation des types de contrôles Qt Quick dans les déclarations de propriétés

Comme indiqué dans Qt Quick Templates 2 QML Typeschaque type de Qt Quick Controls est soutenu par un type "modèle" C++. Ces types sont des implémentations non visuelles de la logique et du comportement des contrôles.

Par exemple, l'API et le comportement du type Menu sont définis par le type C++ dans Qt Quick Templates. Chaque style qui souhaite fournir un menu doit disposer d'un fichier Menu.qml, et l'élément racine de ce fichier doit être le menu de Qt Quick Templates. Lorsque vous importez QtQuick.Controls et que vous créez un menu en QML, le type que vous obtenez est en fait le menu QML défini par le fichier Menu.qml du style.

Pour utiliser un contrôle comme type dans une déclaration de propriété, vous devez utiliser le type correspondant dans les modèles Qt Quick. Par exemple, supposons que vous ayez un composant PopupOpener, qui est un bouton ouvrant une fenêtre contextuelle :

// PopupButton.qml
import QtQuick.Controls

Button {
    required property Popup popup

    onClicked: popup.open()
}

// main.qml
PopupButton {
    popup: saveChangesDialog
}

Dialog {
    id: saveChangesDialog

    // ...
}

L'exécution de ce code entraînera une erreur :

Unable to assign Dialog_QMLTYPE to Popup_QMLTYPE

Cela est dû à la hiérarchie de l'héritage :

Popup (C++ type in QtQuick.Templates)
│   └── Popup (QML type in QtQuick.Controls)
└── Dialog (C++ type in QtQuick.Templates)
    └── Dialog (QML type in QtQuick.Controls)

Dialog from QtQuick.Controls ne dérive pas de Popup from QtQuick.Controls, mais de QtQuick.Templates.

Utilisez plutôt le modèle Popup de Qt Quick comme type de propriété :

// PopupButton.qml
import QtQuick.Controls
import QtQuick.Templates as T

Button {
    required property T.Popup popup

    onClicked: popup.open()
}

Pour plus d'informations sur le module Qt Quick Controls, voir la documentation du module Qt Quick Controls.

Qt Quick Lignes directrices sur les contrôles

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

Qt Quick Controls QML Types

Types QML

Utilisation des types de contrôles Qt Quick dans les déclarations de propriétés

Informations connexes