Action QML Type

Action abstraite de l'interface utilisateur. En savoir plus...

• Liste de tous les membres, y compris les membres hérités

Propriétés

• checkable : bool
• checked : bool
• enabled : bool
• icon
  • icon.cache : bool
  • icon.color : color
  • icon.height : int
  • icon.name : string
  • icon.source : url
  • icon.width : int
• shortcut : keysequence
• text : string

Signaux

• toggled(QtObject source)
• triggered(QtObject source)

Méthodes

• void toggle(QtObject source)
• void trigger(QtObject source)

Description détaillée

Une action représente une action abstraite de l'interface utilisateur pouvant comporter des raccourcis et être associée à des éléments de menu et à des boutons de la barre d'outils.

Les actions peuvent contenir une action de sélection ( text), une action de sélection de liste ( icon) et une action de sélection de liste de sélection ( shortcut). Les actions sont généralement triggered es par l'utilisateur via des éléments de menu, des boutons de barre d'outils ou des raccourcis clavier. Une action de sélection de liste ( checkable ) bascule son état de sélection ( checked ) lorsqu'elle est déclenchée.

Action {
    id: copyAction
    text: qsTr("&Copy")
    icon.name: "edit-copy"
    shortcut: StandardKey.Copy
    onTriggered: window.activeFocusItem.copy()
}

Les actions sont couramment utilisées pour implémenter des commandes d’application pouvant être invoquées via des éléments de menu, des boutons de barre d’outils et des raccourcis clavier. Étant donné que l’utilisateur s’attend à ce que les commandes soient exécutées de la même manière, quelle que soit l’interface utilisateur utilisée, il est utile de représenter ces commandes sous forme d’actions partageables.

Les actions peuvent également servir à séparer la logique de la présentation visuelle. Par exemple, lorsque l’on déclare des boutons et des éléments de menu dans des fichiers ` .ui.qml `, les actions peuvent être déclarées ailleurs et attribuées depuis l’extérieur.

ToolButton {
    id: toolButton
    action: copyAction
}

Lorsqu’une action est associée à des boutons et à des éléments de menu, les états « enabled » (sélectionné), « checkable » (sélectionné par défaut) et « checked » (actif) sont synchronisés automatiquement. Par exemple, dans un traitement de texte, si l’utilisateur clique sur un bouton « Gras » de la barre d’outils, l’élément de menu « Gras » sera automatiquement coché. Par défaut, les boutons et les éléments de menu héritent de leurs propriétés « text » et « icon » de l’action. Une propriété « text » ou « icon » spécifique à l’action peut être redéfinie pour un contrôle donné en spécifiant directement « text » ou « icon » sur ce contrôle.

MenuItem {
    id: menuItem
    action: copyAction
    text: qsTr("&Copy selected Text")
}

Étant donné qu’Action représente une action de l’interface utilisateur, elle est destinée à être attribuée à un MenuItem, un ToolButton ou tout autre contrôle héritant de AbstractButton. Pour les raccourcis clavier, le type Shortcut, plus simple, est plus approprié.

Voir également MenuItem, ToolButton et Shortcut.

Documentation sur les propriétés

checkable : bool

Cette propriété indique si l'action est cochable. La valeur par défaut est « false ».

Une action cochable bascule entre l'état coché (activé) et non coché (désactivé) lorsqu'elle est déclenchée.

Voir également checked.

checked : bool

Cette propriété s'applique que la case soit cochée ou non.

Voir également checkable.

enabled : bool

Cette propriété indique si l'action est activée. La valeur par défaut est « true ».

icon group

shortcut : keysequence

Cette propriété contient le raccourci clavier de l'action. La séquence de touches peut être définie comme l'une des valeurs suivantes : standard keyboard shortcuts(par exemple, StandardKey.Copy), ou elle peut être décrite par une chaîne de caractères contenant une séquence de quatre touches au maximum, nécessaires pour déclencher le raccourci.

Action {
    shortcut: "Ctrl+E,Ctrl+W"
    onTriggered: edit.wrapMode = TextEdit.Wrap
}

text : string

Cette propriété contient une description textuelle de l'action.

Documentation sur les signaux

toggled(QtObject source)

Ce signal est émis lorsque l'action est activée ou désactivée. L'argument « source » identifie l'objet qui a activé ou désactivé l'action.

Par exemple, si l’action est associée à un élément de menu et à un bouton de la barre d’outils, elle est activée ou désactivée lorsque le contrôle est activé ou désactivé, lorsque le raccourci est activé, ou lorsque la fonction toggle() est appelée directement.

triggered(QtObject source)

Ce signal est émis lorsque l'action est déclenchée. L'argument source identifie l'objet qui a déclenché l'action.

Par exemple, si l'action est associée à un élément de menu et à un bouton de la barre d'outils, elle est déclenchée lorsque l'on clique sur le contrôle, lorsque le raccourci est activé ou lorsque la fonction ` trigger()` est appelée directement.

Documentation de la méthode

void toggle(QtObject source)

Active ou désactive l'action et déclenche l'événement ` toggled()` si celle-ci est activée, avec un objet ` source ` facultatif défini.

void trigger(QtObject source)

Déclenche l'action et émet un événement « triggered() » si cette fonctionnalité est activée, avec un objet « source » facultatif défini.