AbstractButton QML Type
Type de base abstrait fournissant des fonctionnalités communes aux boutons. En savoir plus…
| Import Statement: | import QtQuick.Controls |
| Inherits: | |
| Inherited By: |
Propriétés
- action : Action
(since QtQuick.Controls 2.3 (Qt 5.10)) - autoExclusive : bool
- autoRepeat : bool
- autoRepeatDelay : int
(since QtQuick.Controls 2.4 (Qt 5.11)) - autoRepeatInterval : int
(since QtQuick.Controls 2.4 (Qt 5.11)) - checkable : bool
- checked : bool
- display : enumeration
(since QtQuick.Controls 2.3 (Qt 5.10)) - down : bool
- icon
(since QtQuick.Controls 2.3)- icon.cache : bool
(since QtQuick.Controls 2.3) - icon.color : color
(since QtQuick.Controls 2.3) - icon.height : int
(since QtQuick.Controls 2.3) - icon.name : string
(since QtQuick.Controls 2.3) - icon.source : url
(since QtQuick.Controls 2.3) - icon.width : int
(since QtQuick.Controls 2.3)
- icon.cache : bool
- implicitIndicatorHeight : real
(since QtQuick.Controls 2.5 (Qt 5.12)) - implicitIndicatorWidth : real
(since QtQuick.Controls 2.5 (Qt 5.12)) - indicator : Item
- pressX : real
(since QtQuick.Controls 2.4 (Qt 5.11)) - pressY : real
(since QtQuick.Controls 2.4 (Qt 5.11)) - pressed : bool
- text : string
Signaux
- canceled()
- clicked()
- doubleClicked()
- pressAndHold()
- pressed()
- released()
- toggled()
(since QtQuick.Controls 2.2 (Qt 5.9))
Méthodes
- void animateClick()
(since Qt 6.8) - void click()
(since Qt 6.8) - void toggle()
Description détaillée
AbstractButton fournit l'interface pour les contrôles présentant un comportement similaire à celui d'un bouton ; par exemple, les boutons poussoirs et les contrôles cochables tels que les boutons radio et les cases à cocher. En tant que contrôle abstrait, il ne dispose d'aucune implémentation de délégué, celles-ci étant laissées à la charge des types qui en dérivent.
Voir également « ButtonGroup » et « Button Controls ».
Documentation des propriétés
action : Action [since QtQuick.Controls 2.3 (Qt 5.10)]
Cette propriété définit l'action associée au bouton.
Cette propriété a été introduite dans QtQuick.Controls 2.3 (Qt 5.10).
Voir également Action.
autoExclusive : bool
Cette propriété détermine si l'exclusivité automatique est activée.
Si l'exclusivité automatique est activée, les boutons cochables appartenant au même élément parent se comportent comme s'ils faisaient partie du même groupe de boutons « ButtonGroup ». Un seul bouton peut être coché à la fois ; cocher un autre bouton décoche automatiquement celui qui était coché auparavant.
Remarque : cette propriété n'a aucun effet sur les boutons appartenant à une « ButtonGroup ».
RadioButton et les « TabButton » sont auto-exclusifs par défaut.
autoRepeat : bool
Cette propriété détermine si le bouton répète les signaux pressed(), released() et clicked() tant qu'il est enfoncé et maintenu enfoncé.
Si cette propriété est définie sur true, le signal pressAndHold() ne sera pas émis.
La valeur par défaut est false.
Le délai initial et l’intervalle de répétition sont définis en millisecondes par les paramètres « autoRepeatDelay » et « autoRepeatInterval ».
autoRepeatDelay : int [since QtQuick.Controls 2.4 (Qt 5.11)]
Cette propriété définit le délai initial de la répétition automatique en millisecondes. La valeur par défaut est 300 ms.
Cette propriété a été introduite dans QtQuick.Controls 2.4 (Qt 5.11).
Voir également autoRepeat et autoRepeatInterval.
autoRepeatInterval : int [since QtQuick.Controls 2.4 (Qt 5.11)]
Cette propriété définit l'intervalle de répétition automatique en millisecondes. La valeur par défaut est de 100 ms.
Cette propriété a été introduite dans QtQuick.Controls 2.4 (Qt 5.11).
Voir également autoRepeat et autoRepeatDelay.
checkable : bool
Cette propriété indique si le bouton est cochable.
Un bouton cochable bascule entre l'état coché (activé) et l'état non coché (désactivé) lorsque l'utilisateur clique dessus ou appuie sur la barre d'espace alors que le bouton a le focus.
La valeur par défaut est « false ».
Voir également checked.
checked : bool
Cette propriété indique si la case est cochée.
Depuis Qt 6.2, la modification de cette propriété n'affecte plus la propriété checkable. Définissez explicitement la propriété checkable si nécessaire.
Voir également checkable.
display : enumeration [since QtQuick.Controls 2.3 (Qt 5.10)]
Cette propriété détermine la manière dont les éléments « icon » et « text » s'affichent à l'intérieur du bouton.
| Affichage | Résultat |
|---|---|
AbstractButton.IconOnly |
|
AbstractButton.TextOnly |
|
AbstractButton.TextBesideIcon (par défaut) |
|
AbstractButton.TextUnderIcon |
|
Cette propriété a été introduite dans QtQuick.Controls 2.3 (Qt 5.10).
Voir aussi spacing et padding.
down : bool
Cette propriété indique si le bouton est visuellement en position enfoncée.
À moins d'être explicitement définie, cette propriété reprend la valeur de ` pressed`. Pour revenir à la valeur par défaut, définissez cette propriété sur ` undefined`.
Voir également pressed.
icon group
icon.cache : bool [since QtQuick.Controls 2.3]
icon.color : color [since QtQuick.Controls 2.3]
icon.height : int [since QtQuick.Controls 2.3]
icon.name : string [since QtQuick.Controls 2.3]
icon.source : url [since QtQuick.Controls 2.3]
icon.width : int [since QtQuick.Controls 2.3]
| Nom | Description |
|---|---|
| nom | Cette propriété contient le nom de l'icône à utiliser. L'icône sera chargée à partir du thème de la plateforme. Si l'icône est présente dans le thème, elle sera toujours utilisée, même si la propriété « icon.source » est également définie. Si l'icône n'est pas trouvée, la propriété « icon.source » sera utilisée à la place. Pour plus d’informations sur les icônes de thème, consultez QIcon::fromTheme(). |
| source | Cette propriété contient le nom de l'icône à utiliser. L'icône sera chargée comme une image classique. Si la propriété « icon.name » est définie et fait référence à une icône de thème valide, celle-ci sera toujours utilisée à la place de cette propriété. |
| width | Cette propriété définit la largeur de l'icône. La largeur de l'icône ne dépassera jamais cette valeur, mais elle sera réduite si nécessaire. |
| hauteur | Cette propriété définit la hauteur de l'icône. La hauteur de l'icône ne dépassera jamais cette valeur, mais elle sera réduite si nécessaire. |
| couleur | Cette propriété définit la couleur de l'icône. L'icône est teintée de la couleur spécifiée, sauf si la couleur est définie sur « |
| cache | Cette propriété indique si l'icône doit être mise en cache. La valeur par défaut est « true ». Pour plus d’informations, consultez cache. Cette propriété a été introduite dans la version 2.13 d'QtQuick.Controls. |
Ces propriétés ont été introduites dans QtQuick.Controls 2.3.
Voir également text, display et la section « Icônes » dans Qt Quick Controls.
implicitIndicatorHeight : real [read-only, since QtQuick.Controls 2.5 (Qt 5.12)]
Cette propriété contient la hauteur implicite de l'indicateur.
Sa valeur est égale à indicator ? indicator.implicitHeight : 0.
Elle est généralement utilisée, conjointement avec ` implicitContentHeight ` et ` implicitBackgroundHeight`, pour calculer la ` implicitHeight`.
Cette propriété a été introduite dans QtQuick.Controls 2.5 (Qt 5.12).
Voir également implicitIndicatorWidth.
implicitIndicatorWidth : real [read-only, since QtQuick.Controls 2.5 (Qt 5.12)]
Cette propriété contient la largeur implicite de l'indicateur.
Sa valeur est égale à indicator ? indicator.implicitWidth : 0.
Elle est généralement utilisée, conjointement avec implicitContentWidth et implicitBackgroundWidth, pour calculer l'implicitWidth.
Cette propriété a été introduite dans QtQuick.Controls 2.5 (Qt 5.12).
Voir également implicitIndicatorHeight.
indicator : Item
Cette propriété contient l'élément indicateur.
pressX : real [read-only, since QtQuick.Controls 2.4 (Qt 5.11)]
Cette propriété contient la coordonnée x du dernier appui.
Remarque : la valeur est mise à jour lors des déplacements du doigt, mais reste inchangée une fois le doigt retiré.
Cette propriété a été introduite dans QtQuick.Controls 2.4 (Qt 5.11).
Voir également pressY.
pressY : real [read-only, since QtQuick.Controls 2.4 (Qt 5.11)]
Cette propriété contient la coordonnée y du dernier appui.
Remarque : la valeur est mise à jour lors des déplacements du doigt, mais reste inchangée après le relâchement du doigt.
Cette propriété a été introduite dans QtQuick.Controls 2.4 (Qt 5.11).
Voir également pressX.
pressed : bool [read-only]
Cette propriété indique si le bouton est physiquement enfoncé. Un bouton peut être enfoncé soit par un événement tactile, soit par un événement de touche.
Voir également down.
text : string
Cette propriété contient une description textuelle du bouton.
Remarque : ce texte est utilisé à des fins d'accessibilité ; il est donc judicieux de définir une description textuelle même si l'élément de contenu est une image.
Voir également icon, display et contentItem.
Documentation Signal
canceled()
Ce signal est émis lorsque le bouton perd le contrôle de la souris alors qu'il est enfoncé, ou lorsqu'il émettrait le signal « released » mais que le curseur de la souris ne se trouve pas à l'intérieur du bouton.
Remarque : le gestionnaire correspondant est onCanceled.
clicked()
Ce signal est émis lorsque l'utilisateur clique sur le bouton de manière interactive, que ce soit via l'écran tactile, la souris ou le clavier.
Remarque : le gestionnaire correspondant est onClicked.
Voir également click(), animateClick() et Appeler une fonction C++ depuis QML lorsqu'un bouton est cliqué.
doubleClicked()
Ce signal est émis lorsque l'utilisateur double-clique sur le bouton de manière interactive, que ce soit au toucher ou avec la souris.
Remarque : le gestionnaire correspondant est onDoubleClicked.
pressAndHold()
Ce signal est émis lorsque l'utilisateur appuie sur le bouton et le maintient enfoncé de manière interactive, que ce soit au toucher ou à l'aide de la souris. Il n'est pas émis lorsque l'option « autoRepeat » est activée.
Remarque : le gestionnaire correspondant est onPressAndHold.
pressed()
Ce signal est émis lorsque l'utilisateur appuie sur le bouton de manière interactive, que ce soit au toucher, à l'aide de la souris ou du clavier.
Remarque : le gestionnaire correspondant est onPressed.
released()
Ce signal est émis lorsque l'utilisateur relâche le bouton de manière interactive, que ce soit par effleurement, à l'aide de la souris ou du clavier.
Remarque : le gestionnaire correspondant est onReleased.
[since QtQuick.Controls 2.2 (Qt 5.9)] toggled()
Ce signal est émis lorsqu'un bouton à cocher est activé ou désactivé de manière interactive par l'utilisateur via un geste tactile, la souris ou le clavier.
Remarque : le gestionnaire correspondant est onToggled.
Ce signal a été introduit dans QtQuick.Controls 2.2 (Qt 5.9).
Documentation de la méthode
[since Qt 6.8] void animateClick()
Simule un clic sur le bouton, avec un délai de 100 millisecondes entre l'appui et le relâchement, tout en animant son aspect visuel.
Tous les signaux associés à un clic sont émis comme il se doit.
Si l'focusPolicy e contient « Qt.ClickFocus », « activeFocus » deviendra « true ».
Cette fonction ne fait rien si le bouton est en état « disabled ».
Appeler à nouveau cette fonction avant que le bouton ne soit relâché réinitialise le temporisateur de relâchement.
Cette méthode a été introduite dans Qt 6.8.
Voir également click(), pressed(), released() et clicked().
[since Qt 6.8] void click()
Simule un clic sur le bouton sans délai entre le moment où l'on appuie dessus et celui où on le relâche.
Tous les signaux associés à un clic sont émis comme il se doit.
Si l'focusPolicy e contient Qt.ClickFocus, activeFocus deviendra true.
Cette fonction ne fait rien si le bouton est en état « disabled ».
Appeler à nouveau cette fonction avant que le bouton ne soit relâché réinitialise le temporisateur de relâchement.
Cette méthode a été introduite dans Qt 6.8.
Voir également animateClick(), pressed(), released() et clicked().
void toggle()
Active ou désactive l'état coché du bouton.
Voir également click() et animateClick().
© 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.
