contrôle des boutons
Qt Quick Control fournit une série de commandes de type bouton.
| Type de base abstrait qui fournit des fonctionnalités communes pour les boutons |
|
| Boutons sur lesquels vous pouvez cliquer pour exécuter des commandes ou répondre à des questions |
|
| Vérifiez le bouton qui peut être activé ou désactivé |
|
| Bouton de contrôle déclenché lorsqu'il est enfoncé suffisamment longtemps |
|
| Bouton radio dédié qui peut être activé ou désactivé |
|
| Un contrôle bouton aux coins arrondis sur lequel l’utilisateur peut cliquer. |
|
| Bouton pouvant être activé ou désactivé |
|
| Boutons qui ressemblent à une barre d'outils |
Chaque type de bouton a son cas d’utilisation spécifique. Les sections suivantes fournissent des conseils sur la sélection du type de bouton approprié en fonction de votre cas d'utilisation.
contrôle des boutons
Est un contrôle cliquable qui lance une action ou ouvre ou ferme une fenêtre contextuelle. Les boutons ont généralement des étiquettes de texte mais peuvent également contenir des icônes.
Les boutons sont un contrôle très approprié lorsqu'une action doit être effectuée dans une fenêtre contextuelle ou une boîte de dialogue. Les exemples les plus courants sont Appliquer, Annuler, Enregistrer, Fermer et Aide.
suggestion:
- Le texte du bouton doit être un prédicat qui décrit l'action, ou un nom qui correspond au titre de la fenêtre contextuelle qui s'ouvrira.
- N'utilisez pas de boutons pour définir l'état. Plus adapté pour ça.
- Utilisez la police par défaut, sauf indication contraire dans les directives de votre interface utilisateur.
- Si le texte est localisé, réfléchissez à l’impact qu’un texte plus long aura sur la mise en page.
Voir aussi et
contrôle de case à cocher
Utilisé pour créer une liste d'options à sélection multiple. N'importe quel nombre d'options peut être sélectionné, y compris aucune, mais les options ne doivent pas s'exclure mutuellement.
Utilisez une seule option pour représenter un choix oui/non, par exemple lorsque vous devez accepter les conditions de service dans un formulaire.
Pour les options oui/non simples, des commutateurs peuvent également être utilisés. Si la sélection implique une option, il est préférable d'utiliser . Si elle implique une action à réaliser, il est recommandé de la basculer.
Lorsque les options peuvent être regroupées, une sélection partielle peut être utilisée pour représenter l’ensemble du groupe. Cochez cette case lorsque l'utilisateur sélectionne certains enfants (mais pas tous) du groupe.
Les trois statuts de vérification disponibles sont : Coché, Partiellement coché et Non coché.
Les options vérifiables sont généralement répertoriées verticalement.
suggestion:
- L’étiquette de la case à cocher doit être une déclaration avec une coche qui est vraie et une déclaration sans coche qui est fausse.
- Les étiquettes des cases à cocher ne doivent pas contenir de déclarations négatives.
- Utilisez la police par défaut, sauf indication contraire dans les directives de l'interface utilisateur.
- Si le texte est localisé, réfléchissez à l’impact qu’un texte plus long aura sur la mise en page.
Voir
Contrôle du bouton de retard
est un bouton qui contient un délai avant de déclencher l'action. Ce délai évite les pressions accidentelles.
suggestion:
- Utilisé dans les interfaces utilisateur tactiles.
- Utilisé pour les opérations qui doivent être déclenchées avec précaution.
Voir aussi et
contrôle du bouton radio
Utilisé pour sélectionner une seule option parmi un ensemble d’options. La sélection d'une option désélectionne automatiquement l'option précédemment sélectionnée.
Si vous ne disposez que de deux options mutuellement exclusives, combinez-les dans une case à cocher ou un commutateur.
suggestion:
- Limitez le texte de l’étiquette à une seule ligne.
- Assurez-vous que les options par défaut raisonnables sont sélectionnées.
- Répertoriez les options verticalement.
- Si le texte est localisé, réfléchissez à l’impact qu’un texte plus long aura sur la mise en page.
- Utilisez la police par défaut, sauf indication contraire dans les directives de l'interface utilisateur.
- Par exemple, ne faites pas une liste trop longue.
- Pour éviter toute confusion, ne placez pas deux ensembles de boutons radio côte à côte.
Utilisations spécifiques des commandes de boutons :
Un type de base abstrait qui fournit des fonctionnalités communes pour les boutons. Plus. . .
| Déclaration d'importation : | importer QtQuick.Controls 2.15 |
| Depuis: | Qt 5.7 |
| Hérite : | |
| Hérité de : | Button , CheckBox , DelayButton , ItemDelegate , MenuBarItem , MenuItem , RadioButton , Switch et TabButton |
performance
- action : action
- autoExclusif : booléen
- autoRepeat : booléen
- autoRepeatDelay : int
- autoRepeatInterval : int
- vérifiable : booléen
- vérifié : booléen
- affichage : énumération
- vers le bas : booléen
- icône
- icône.cache : booléen
- icon.color : couleur
- icône.hauteur : int
- icon.name : chaîne
- icône.source : url
- icône.width : int
- implicitIndicatorHeight : réel
- implicitIndicatorWidth : réel
- indicateur : Article
- pressX : réel
- pressY : réel
- pressé : booléen
- texte : chaîne
Signal
- annulé ()
- cliqué ()
- double clic ()
- appuyerEtMaintenir ()
- appuyé sur ()
- libéré ()
- basculé ()
méthode
- basculer vide ()
Description détaillée
Les boutons abstraits fournissent une interface pour les contrôles ayant un comportement semblable à celui d'un bouton ; par exemple, les boutons et les contrôles cochables tels que les boutons radio et les cases à cocher. En tant que contrôle abstrait, il n'a pas d'implémentations déléguées, les laissant aux types qui en dérivent.
Voir aussi et.
document de propriétés
| 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 aussi .
| autoExclusif : booléen |
Cette propriété indique si l'exclusivité automatique est activée.
Si l'exclusivité automatique est activée, les boutons cochables appartenant au même parent se comportent comme s'ils étaient identiques. Un seul bouton peut être coché à la fois ; la sélection d'un autre bouton décoche automatiquement le bouton précédemment sélectionné.
Remarque : Cette propriété n'a aucun effet sur le bouton auquel elle appartient.
Et c'est automatiquement exclusif par défaut.
| autoRepeat : booléen |
Cette propriété est valable si le bouton est répété ou non et émet un signal lorsque le bouton est enfoncé et maintenu enfoncé.
Si cette propriété est définie sur , aucun signal ne sera émis.true
La valeur par défaut est .false
Le délai initial et l'intervalle de répétition sont définis en millisecondes.
| autoRepeatDelay : int |
Cette propriété contient le délai initial en millisecondes pour la répétition automatique. La valeur par défaut est ms.300
Cette propriété a été introduite dans QtQuick.Controls 2.4 (Qt 5.11).
Voir aussi et.
| autoRepeatInterval : int |
Cette propriété contient l'intervalle de répétition automatique en millisecondes. La valeur par défaut est ms.100
Cette propriété a été introduite dans QtQuick.Controls 2.4 (Qt 5.11).
Voir aussi et.
| vérifiable : booléen |
Cette propriété indique si le bouton est vérifiable.
Bascule entre coché (activé) et décoché (désactivé) lorsque l'utilisateur clique sur le bouton cochable ou appuie sur la barre d'espace alors que le bouton a le focus actif.
Définir pour forcer cette propriété à être.truetrue
La valeur par défaut est .false
Voir aussi .
| vérifié : booléen |
Cette propriété est valable si le bouton est sélectionné ou non.
Voir aussi .
| affichage : énumération |
Cette propriété détermine comment et apparaît dans le bouton.
| montrer | résultat |
|---|---|
AbstractButton.IconOnly |
|
AbstractButton.TextOnly |
|
AbstractButton.TextBesideIcon |
|
AbstractButton.TextUnderIcon |
|
Cette propriété a été introduite dans QtQuick.Controls 2.3 (Qt 5.10).
Voir aussi et.
| vers le bas : booléen |
Cette propriété indique si le bouton est visuellement fermé.
La valeur que cette propriété suivra sauf si elle est explicitement définie. Pour revenir à la valeur par défaut, définissez cette propriété sur .undefined
Voir aussi .
Ce groupe de propriétés a été ajouté à . Contrôles 2.3.
| nom | décrire |
|---|---|
| nom | Cette propriété contient le nom de l'icône à utiliser. Les icônes seront chargées à partir du thème de la plateforme. Si l'icône est trouvée dans le thème, elle sera toujours utilisée ; même si elle est également définie. Si cette icône n'est pas trouvée, elle sera utilisée à la place. Pour plus d'informations sur les icônes de thème, voir . |
| source | Cette propriété contient le nom de l'icône à utiliser. L'icône se chargera comme une image normale. Si elle est définie et faisant référence à une icône de thème valide, elle sera toujours utilisée à la place de cette propriété. |
| largeur | Cette propriété contient la largeur de l'icône. L'icône ne sera jamais plus large que cette valeur, mais sera réduite si nécessaire. |
| haut | Cette propriété contient la hauteur de l'icône. La hauteur de l'icône ne dépassera jamais cette valeur, mais diminuera si nécessaire. |
| couleur | Cette propriété contient la couleur de l'icône. 图标使用指定的颜色着色，除非颜色设置为 。 |
| 缓存 | 此属性指定是否应缓存图标。 默认值为 true。 此属性已在 中介绍。控件 2.13. |
另请参见 、 和 。
| [read-only]implicitIndicatorHeight : real |
此属性保存隐式指示器高度。
该值等于 。indicator ? indicator.implicitHeight : 0
这通常与 和 一起使用来计算 。
此属性在 QtQuick.Controls 2.5 （Qt 5.12） 中引入。
另请参阅。
| [read-only]implicitIndicatorWidth : real |
此属性保存隐式指示器宽度。
该值等于 。indicator ? indicator.implicitWidth : 0
这通常与 和 一起使用来计算 。
此属性在 QtQuick.Controls 2.5 （Qt 5.12） 中引入。
另请参阅。
| indicator : Item |
此属性保存指示器项。
| [read-only]pressX : real |
此属性保存上次按下的 x 坐标。
注意： 该值在触摸移动时更新，但在触摸释放后保持不变。
此属性在 QtQuick.Controls 2.4 （Qt 5.11） 中引入。
另请参阅。
| [read-only]pressY : real |
此属性保存上次按下的 y 坐标。
注意： 该值在触摸移动时更新，但在触摸释放后保持不变。
此属性在 QtQuick.Controls 2.4 （Qt 5.11） 中引入。
另请参阅。
| [read-only]pressed : bool |
此属性保存按钮是否被物理按下。按钮可以通过触摸或按键事件按下。
另请参阅。
| text : string |
This property holds a textual description of the button.
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 aussi icon , display et contentItem .
documentation des signaux
| annulé() |
Ce signal est émis lorsque le bouton perd la prise de la souris lorsqu'il est enfoncé, ou lorsqu'il émet un signal mais que le curseur de la souris n'est pas à l'intérieur du bouton.
REMARQUE : le gestionnaire correspondant est .onCanceled
| cliqué() |
Ce signal est émis lorsque l'utilisateur clique de manière interactive sur un bouton via le toucher, la souris ou le clavier.
REMARQUE : le gestionnaire correspondant est .onClicked
| double clic() |
Ce signal est émis lorsque l'utilisateur double-clique de manière interactive sur le bouton via le toucher ou la souris.
REMARQUE : le gestionnaire correspondant est .onDoubleClicked
| appuyerEtMaintenir() |
Ce signal est émis lorsque l'utilisateur appuie et maintient le bouton de manière interactive via le toucher ou la souris. Il ne sera pas émis lorsqu'il est activé.
REMARQUE : le gestionnaire correspondant est .onPressAndHold
| pressé() |
Ce signal est émis lorsque l'utilisateur appuie de manière interactive sur un bouton via le toucher, la souris ou le clavier.
REMARQUE : le gestionnaire correspondant est .onPressed
| libéré() |
Ce signal est émis lorsque l'utilisateur relâche le bouton de manière interactive via le toucher, la souris ou le clavier.
REMARQUE : le gestionnaire correspondant est .onReleased
| basculé() |
Ce signal est émis lorsque l'utilisateur active de manière interactive un bouton inspectable via le toucher, la souris ou le clavier.
REMARQUE : le gestionnaire correspondant est .onToggled
Ce signal a été introduit dans QtQuick.Controls 2.2 (Qt 5.9).