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: | Button, CheckBox, DelayButton, ItemDelegate, MenuBarItem, MenuItem, RadioButton, Switch, and TabButton |
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
- icon.cache : bool
- icon.color : color
- icon.height : int
- icon.name : string
- icon.source : url
- icon.width : int
- 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.
Propriété Documentation
action : Action |
Cette propriété contient l'action du bouton.
Cette propriété a été introduite dans QtQuick.Controls 2.3 (Qt 5.10).
Voir également 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 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 |
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 |
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 |
display : enumeration |
down : bool |
Ce groupe de propriétés a été ajouté dans QtQuick.Controls 2.3.
| Nom | Description de la propriété |
|---|---|
| nom | Cette propriété contient le nom de l'icône à utiliser. L'icône est 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. |
Voir également text, display, et Icônes dans Qt Quick Controls.
implicitIndicatorHeight : real |
Cette propriété définit 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 la hauteur de l'indicateur implicitHeight.
Cette propriété a été introduite dans QtQuick.Controls 2.5 (Qt 5.12).
Voir aussi implicitIndicatorWidth.
implicitIndicatorWidth : real |
Cette propriété contient la largeur implicite de l'indicateur.
La valeur est égale à indicator ? indicator.implicitWidth : 0.
Elle est généralement utilisée, avec implicitContentWidth et implicitBackgroundWidth, pour calculer l'indicateur 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 de l'indicateur.
pressX : real |
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 |
Cette propriété contient la coordonnée y de la dernière pression.
Remarque : la valeur est mise à jour lors des déplacements de la touche, mais reste intacte après le relâchement de la touche.
Cette propriété a été introduite dans QtQuick.Controls 2.4 (Qt 5.11).
Voir aussi pressX.
pressed : bool |
Cette propriété indique si le bouton est physiquement enfoncé. Un bouton peut être pressé par des événements tactiles ou par des événements de touches.
Voir également 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.
Signal Documentation
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 n'est 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 au moyen du toucher, de la souris ou du 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 et le maintient enfoncé de manière interactive au moyen du toucher ou de la souris. Il n'est pas émis lorsque autoRepeat est activé.
Note : Le gestionnaire correspondant est onPressAndHold.
pressed() |
Ce signal est émis lorsque l'utilisateur appuie sur le bouton de manière interactive au moyen du toucher, de la souris ou du 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 au moyen du toucher, de la souris ou du clavier.
Remarque : le gestionnaire correspondant est onReleased.
|
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
|
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.
|
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 également animateClick(), pressed(), released() et clicked().
void toggle() |
Bascule l'état coché du bouton.
Voir également click() et animateClick().
© 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.
