AbstractButton QML Type
Type de base abstrait offrant des fonctionnalités communes aux boutons. Plus d'informations...
| 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 ayant un comportement similaire à celui d'un bouton, par exemple les boutons poussoirs et les contrôles à cocher tels que les boutons radio et les cases à cocher. En tant que contrôle abstrait, il n'a pas d'implémentation de délégués, les laissant aux types qui en dérivent.
Voir également ButtonGroup et Contrôles de bouton.
Documentation sur les propriétés
action : Action [since QtQuick.Controls 2.3 (Qt 5.10)]
Cette propriété contient l'action du bouton.
Cette propriété a été introduite dans QtQuick.Controls 2.3 (Qt 5.10).
Voir aussi Action.
autoExclusive : bool
Cette propriété indique si l'auto-exclusivité est activée.
Si l'auto-exclusivité est activée, les boutons à cocher qui appartiennent au même élément parent se comportent comme s'ils faisaient partie du même site ButtonGroup. Un seul bouton peut être coché à la fois ; le fait de cocher un autre bouton décoche automatiquement le bouton précédemment coché.
Remarque : cette propriété n'a aucun effet sur les boutons appartenant à un élément ButtonGroup.
RadioButton et TabButton sont auto-exclusifs par défaut.
autoRepeat : bool
Cette propriété indique si le bouton répète les signaux pressed(), released() et clicked() lorsqu'il est enfoncé et maintenu enfoncé.
Si la valeur de cette propriété est 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 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 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 contrôlable.
Un bouton vérifiable bascule entre vérifié (on) et non vérifié (off) lorsque l'utilisateur clique dessus ou appuie sur la barre d'espacement alors que le bouton a le focus actif.
La valeur par défaut est false.
Voir également checked.
checked : bool
Cette propriété indique si le bouton est coché.
Depuis Qt 6.2, la définition de cette propriété n'affecte plus la propriété checkable. Définissez explicitement la propriété checkable si nécessaire.
Voir aussi checkable.
display : enumeration [since QtQuick.Controls 2.3 (Qt 5.10)]
Cette propriété détermine la manière dont les adresses icon et text sont affichées dans le 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 abaissé.
Sauf si elle est explicitement définie, cette propriété suit la valeur de pressed. Pour revenir à la valeur par défaut, définissez cette propriété à 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 de l'entreprise | Description du nom |
|---|---|
| nom | Cette propriété contient le nom de l'icône à utiliser. L'icône sera chargée à partir du thème de la plate-forme. Si l'icône est trouvée dans le thème, elle sera toujours utilisée, même si icon.source est également défini. Si l'icône n'est pas trouvée, icon.source sera utilisé à la place. Pour plus d'informations sur les icônes de thème, voir QIcon::fromTheme(). |
| source | Cette propriété contient le nom de l'icône à utiliser. L'icône sera chargée comme une image normale. Si icon.name est défini 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, voir cache. Cette propriété a été introduite dans QtQuick.Controls 2.13. |
Ces propriétés ont été introduites dans QtQuick.Controls 2.3.
Voir également text, display, et Icônes dans Qt Quick Controls.
implicitIndicatorHeight : real [read-only, since QtQuick.Controls 2.5 (Qt 5.12)]
Cette propriété contient la hauteur de l'indicateur implicite.
La valeur est égale à indicator ? indicator.implicitHeight : 0.
Elle est généralement utilisée, avec implicitContentHeight et implicitBackgroundHeight, pour calculer implicitHeight.
Cette propriété a été introduite dans QtQuick.Controls 2.5 (Qt 5.12).
Voir aussi implicitIndicatorWidth.
implicitIndicatorWidth : real [read-only, since QtQuick.Controls 2.5 (Qt 5.12)]
Cette propriété définit la largeur de l'indicateur implicite.
La valeur est égale à indicator ? indicator.implicitWidth : 0.
Elle est généralement utilisée, avec implicitContentWidth et implicitBackgroundWidth, pour calculer implicitWidth.
Cette propriété a été introduite dans QtQuick.Controls 2.5 (Qt 5.12).
Voir aussi implicitIndicatorHeight.
indicator : Item
Cette propriété contient l'élément de l'indicateur.
pressX : real [read-only, since QtQuick.Controls 2.4 (Qt 5.11)]
Cette propriété contient la coordonnée x de la dernière pression.
Remarque : la valeur est mise à jour lors des déplacements du toucher, mais reste intacte après le relâchement du toucher.
Cette propriété a été introduite dans QtQuick.Controls 2.4 (Qt 5.11).
Voir aussi pressY.
pressY : real [read-only, since QtQuick.Controls 2.4 (Qt 5.11)]
Cette propriété contient la coordonnée y de la dernière pression.
Remarque : la valeur est mise à jour lors des déplacements du toucher, mais reste intacte après le relâchement du toucher.
Cette propriété a été introduite dans QtQuick.Controls 2.4 (Qt 5.11).
Voir aussi pressX.
pressed : bool [read-only]
Cette propriété indique si le bouton est physiquement enfoncé. Un bouton peut être enfoncé par des événements tactiles ou par des touches.
Voir aussi down.
text : string
Cette propriété contient une description textuelle du bouton.
Remarque : le texte est utilisé à des fins d'accessibilité, il est donc logique de définir une description textuelle même si l'élément de contenu est une image.
Voir également icon, display, et contentItem.
Documentation sur les signaux
canceled()
Ce signal est émis lorsque le bouton perd l'emprise 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 le bouton est cliqué de manière interactive par l'utilisateur via le toucher, la souris ou le clavier.
Remarque : le gestionnaire correspondant est onClicked.
Voir également click(), animateClick() et Appeler une fonction C++ à partir de QML lorsqu'un bouton est cliqué.
doubleClicked()
Ce signal est émis lorsque l'utilisateur double-clique sur le bouton de manière interactive au moyen du toucher ou de la souris.
Remarque : le gestionnaire correspondant est onDoubleClicked.
pressAndHold()
Ce signal est émis lorsque l'utilisateur appuie sur le bouton de manière interactive et le maintient enfoncé par le biais du toucher ou de la souris. Il n'est pas émis lorsque autoRepeat est activé.
Remarque : le gestionnaire correspondant est onPressAndHold.
pressed()
Ce signal est émis lorsque l'utilisateur appuie sur le bouton de manière interactive via le toucher, la souris ou le clavier.
Remarque : le gestionnaire correspondant est onPressed.
released()
Ce signal est émis lorsque le bouton est relâché de manière interactive par l'utilisateur via le toucher, la souris ou le 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é de manière interactive par l'utilisateur au moyen du toucher, de la souris ou du 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 le clic sur le bouton, avec un délai de 100 millisecondes entre la pression et le relâchement, en animant son état visuel au cours du processus.
Tous les signaux associés à un clic sont émis comme il se doit.
Si le site focusPolicy comprend Qt.ClickFocus, activeFocus deviendra true.
Cette fonction ne fait rien si le bouton est disabled.
Le fait d'appeler à nouveau cette fonction avant que le bouton ne soit relâché réinitialise la minuterie de relâchement.
Cette méthode a été introduite dans Qt 6.8.
Voir aussi click(), pressed(), released() et clicked().
[since Qt 6.8] void click()
Simule le clic sur le bouton sans délai entre la pression et le relâchement.
Tous les signaux associés à un clic sont émis comme il se doit.
Si le site focusPolicy comprend le site Qt.ClickFocus, le site activeFocus deviendra le site true.
Cette fonction ne fait rien si le bouton est disabled.
Un nouvel appel à cette fonction avant que le bouton ne soit relâché réinitialise la minuterie de relâchement.
Cette méthode a été introduite dans Qt 6.8.
Voir aussi animateClick(), pressed(), released() et clicked().
void toggle()
Bascule l'état coché du bouton.
Voir aussi 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.
