Shortcut QML Type

Propose des raccourcis clavier. En savoir plus...

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

Propriétés

• autoRepeat : bool
• context : enumeration
• enabled : bool
• nativeText : string
• portableText : string
• sequence : keysequence
• sequences : list<keysequence>

Signaux

• activated()
• activatedAmbiguously()

Description détaillée

Le type « Raccourci » vous permet de gérer les raccourcis clavier. Le raccourci peut être défini sur l’une des valeurs suivantes : standard keyboard shortcuts, ou il peut être décrit par une chaîne de caractères contenant une séquence de quatre frappes au maximum nécessaires pour activate le raccourci.

Item {
    id: view

    property int currentIndex

    Shortcut {
        sequences: [StandardKey.NextChild]
        onActivated: view.currentIndex++
    }
}

Il est également possible de définir plusieurs sequences de raccourcis, de sorte que le raccourci puisse être activated à l'aide de plusieurs séquences de touches différentes.

Voir également Keys et shortcutOverride().

Documentation sur les propriétés

autoRepeat : bool

Cette propriété détermine si le raccourci peut être répété automatiquement.

La valeur par défaut est « true ».

context : enumeration

Cette propriété contient l'shortcut context.

Les valeurs prises en charge sont :

Shortcut {
    sequence: StandardKey.Quit
    context: Qt.ApplicationShortcut
    onActivated: Qt.quit()
}

enabled : bool

Cette propriété indique si le raccourci est activé.

La valeur par défaut est « true ».

nativeText : string [read-only]

Cette propriété fournit la séquence de touches du raccourci sous la forme d'une chaîne spécifique à la plateforme. Cela signifie qu'elle s'affichera traduite et que, sous macOS, elle ressemblera à une séquence de touches de la barre de menus. Il est préférable d'afficher ce texte à l'utilisateur (par exemple, dans une info-bulle).

Voir également sequence et portableText.

portableText : string [read-only]

Cette propriété fournit la séquence de touches du raccourci sous forme de chaîne de caractères dans un format « portable », adapté à la lecture et à l'écriture dans un fichier. Dans la plupart des cas, elle ressemblera au texte natif sous Windows et X11.

Voir également sequence et nativeText.

sequence : keysequence

Cette propriété contient la séquence de touches du raccourci. La séquence de touches peut être définie comme l'une des valeurs suivantes : standard keyboard shortcuts, ou elle peut être décrite par une chaîne de caractères contenant une séquence de quatre pressions de touches au maximum, nécessaires pour « activate r » le raccourci.

La valeur par défaut est une séquence de touches vide.

Shortcut {
    sequence: "Ctrl+E,Ctrl+W"
    onActivated: edit.wrapMode = TextEdit.Wrap
}

Voir également sequences.

sequences : list<keysequence>

Cette propriété contient plusieurs séquences de touches pour le raccourci. Les séquences de touches peuvent être définies comme l'une des valeurs suivantes : standard keyboard shortcuts, ou elles peuvent être décrites à l'aide de chaînes de caractères contenant des séquences comprenant jusqu'à quatre frappes de touches nécessaires pour « activate r » le raccourci.

Shortcut {
    sequences: [StandardKey.Cut, "Ctrl+X", "Shift+Del"]
    onActivated: edit.cut()
}

Documentation Signal

activated()

Ce signal est émis lorsque le raccourci est activé.

activatedAmbiguously()

Ce signal est émis lorsque le raccourci est activé de manière ambiguë, c'est-à-dire lorsqu'il correspond au début de plusieurs raccourcis.