Action QML Type

Action abstraite de l'interface utilisateur. Plus d'informations...

• 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

Action représente une action abstraite de l'interface utilisateur qui peut avoir des raccourcis et être assignée à des éléments de menu et à des boutons de la barre d'outils.

Les actions peuvent contenir text, un icon et un shortcut. Les actions sont normalement triggered par l'utilisateur via des éléments de menu, des boutons de barre d'outils ou des raccourcis clavier. Une action checkable fait basculer son état 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 généralement utilisées pour mettre en œuvre des commandes d'application qui peuvent ê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 les commandes sous la forme d'actions partageables.

Les actions peuvent également être utilisées pour séparer la logique de la présentation visuelle. Par exemple, lors de la déclaration de boutons et d'éléments de menu dans les fichiers .ui.qml, les actions peuvent être déclarées ailleurs et attribuées de 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, checkable et checked sont automatiquement synchronisés. 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é. Les boutons et les éléments de menu obtiennent par défaut leurs text et icon de l'action. Une action spécifique text ou icon peut être remplacée pour un contrôle spécifique en spécifiant text ou icon directement sur le contrôle.

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

Étant donné que l'action présente une action d'interface utilisateur, elle est destinée à être affectée à un contrôle MenuItem, ToolButton, ou à tout autre contrôle qui hérite 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 vérifiable. La valeur par défaut est false.

Une action vérifiable bascule entre vérifiée (on) et non vérifiée (off) lorsqu'elle est déclenchée.

Voir également checked.

checked : bool

Cette propriété indique si l'action est vérifiée.

Voir aussi 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 de l'action. La séquence de touches peut être définie sur l'une des pages standard keyboard shortcuts, ou peut être décrite par une chaîne 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 du signal

toggled(QtObject source)

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

Par exemple, si l'action est assignée à un élément de menu et à un bouton de barre d'outils, l'action est activée lorsque le contrôle est activé, lorsque le raccourci est activé ou lorsque toggle() est appelé 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 assignée à un élément de menu et à un bouton de barre d'outils, l'action est déclenchée lorsque le contrôle est cliqué, lorsque le raccourci est activé ou lorsque trigger() est appelé directement.

Documentation de la méthode

void toggle(QtObject source)

Bascule l'action et émet toggled() si elle est activée, avec un objet optionnel source défini.

void trigger(QtObject source)

Déclenche l'action et émet triggered() si elle est activée, avec un objet optionnel source défini.