Shortcut QML Type

Fournit des raccourcis clavier. Plus d'informations...

• 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 permet de gérer les raccourcis clavier. Le raccourci peut être défini comme l'un des raccourcis clavier standard keyboard shortcuts, ou il peut être décrit par une chaîne contenant une séquence de quatre touches 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 raccourcis sequences, de manière à ce que le raccourci puisse être activated via plusieurs séquences de touches différentes.

Voir également Keys et shortcutOverride().

Documentation sur les propriétés

autoRepeat : bool

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

La valeur par défaut est true.

context : enumeration

Cette propriété contient l'adresse shortcut context.

Les valeurs prises en charge sont les suivantes :

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 plate-forme. Cela signifie qu'elle sera 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 infobulle).

Voir également sequence et portableText.

portableText : string [read-only]

Cette propriété fournit la séquence de touches du raccourci sous la forme d'une chaîne dans un format "portable", adapté à la lecture et à l'écriture dans un fichier. Dans de nombreux cas, elle ressemblera au texte natif de Windows et de 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 sur l'un des sites standard keyboard shortcuts, ou peut être décrite à l'aide d'une chaîne contenant une séquence de quatre touches maximum nécessaires pour activate 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 aussi 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 sur l'un des sites standard keyboard shortcuts, ou peuvent être décrites par des chaînes contenant des séquences de quatre touches au maximum nécessaires pour activate le raccourci.

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

Documentation sur les signaux

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 qu'il correspond au début de plusieurs raccourcis.