En esta página

Shortcut QML Type

Ofrece atajos de teclado. Más...

Import Statement: import QtQuick

Propiedades

Señales

Descripción detallada

El tipo «Atajo» te permite gestionar los atajos de teclado. El atajo se puede configurar como uno de los standard keyboard shortcuts, o bien se puede describir mediante una cadena que contenga una secuencia de hasta cuatro pulsaciones de teclas necesarias para activate el atajo.

Item {
    id: view

    property int currentIndex

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

También es posible establecer varias combinaciones de teclas ( sequences), de modo que el atajo se pueda activar ( activated ) mediante varias secuencias diferentes de pulsaciones de teclas.

Véase también ` Keys ` y ` shortcutOverride()`.

Documentación de propiedades

autoRepeat : bool

Esta propiedad determina si el atajo puede repetirse automáticamente.

El valor por defecto es « true ».

context : enumeration

Esta propiedad contiene el valor « shortcut context ».

Los valores admitidos son:

ConstanteDescripción
Qt.WindowShortcut(por defecto) El acceso directo está activo cuando su elemento principal se encuentra en una ventana activa de nivel superior.
Qt.ApplicationShortcutEl atajo está activo cuando una de las ventanas de la aplicación está activa.
Shortcut {
    sequence: StandardKey.Quit
    context: Qt.ApplicationShortcut
    onActivated: Qt.quit()
}

enabled : bool

Esta propiedad indica si el atajo está activado.

El valor por defecto es « true ».

nativeText : string [read-only]

Esta propiedad proporciona la secuencia de teclas del atajo como una cadena específica de la plataforma. Esto significa que se mostrará traducida y que, en macOS, se parecerá a una secuencia de teclas de la barra de menús. Lo más recomendable es mostrar este texto al usuario (por ejemplo, en una información sobre herramientas).

Nota: Si se configuran varias secuencias, esta propiedad solo proporciona una representación de la primera.

Véase también sequence y portableText.

portableText : string [read-only]

Esta propiedad proporciona la secuencia de teclas del atajo como una cadena en un formato «portátil», adecuado para leer y escribir en un archivo. En muchos casos, tendrá un aspecto similar al texto nativo de Windows y X11.

Nota: Si se definen varias secuencias, esta propiedad solo proporciona una representación de la primera.

Véase también sequence y nativeText.

sequence : keysequence

Esta propiedad contiene la secuencia de teclas del atajo. La secuencia de teclas puede establecerse como una de las siguientes: standard keyboard shortcuts, o bien puede describirse mediante una cadena que contenga una secuencia de hasta cuatro pulsaciones de teclas necesarias para activate el atajo.

El valor por defecto es una secuencia de teclas vacía.

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

Nota: Dado que las teclas estándar pueden corresponder a un solo atajo en algunas plataformas, pero a varios atajos en otras, recomendamos utilizar siempre sequences para las teclas estándar.

Véase también sequences.

sequences : list<keysequence>

Esta propiedad contiene varias secuencias de teclas para el atajo. Las secuencias de teclas pueden configurarse como una de las opciones de standard keyboard shortcuts, o bien pueden describirse mediante cadenas que contengan secuencias de hasta cuatro pulsaciones de teclas necesarias para activate el atajo.

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

Documentación de Signal

activated()

Esta señal se emite cuando se activa el atajo.

Nota: El controlador correspondiente es onActivated.

activatedAmbiguously()

Esta señal se emite cuando el atajo se activa de forma ambigua, es decir, cuando coincide con el inicio de más de un atajo.

Nota: El controlador correspondiente es onActivatedAmbiguously.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.