En esta página

QShortcut Class

La clase QShortcut se utiliza para crear atajos de teclado. Más información...

Encabezado: #include <QShortcut>
CMake: find_package(Qt6 REQUIRED COMPONENTS Gui)
target_link_libraries(mytarget PRIVATE Qt6::Gui)
qmake: QT += gui
Heredado de: QObject

Propiedades

Funciones públicas

QShortcut(QObject *parent)
(since 6.0) QShortcut(QKeySequence::StandardKey standardKey, QObject *parent, const char *member = nullptr, const char *ambiguousMember = nullptr, Qt::ShortcutContext context = Qt::WindowShortcut)
QShortcut(const QKeySequence &key, QObject *parent, const char *member = nullptr, const char *ambiguousMember = nullptr, Qt::ShortcutContext context = Qt::WindowShortcut)
(since 6.0) QShortcut(QKeySequence::StandardKey key, QObject *parent, Functor functor, Qt::ShortcutContext shortcutContext = Qt::WindowShortcut)
QShortcut(const QKeySequence &key, QObject *parent, Functor functor, Qt::ShortcutContext shortcutContext = Qt::WindowShortcut)
(since 6.0) QShortcut(QKeySequence::StandardKey key, QObject *parent, const QObject *context, Functor functor, Qt::ShortcutContext shortcutContext = Qt::WindowShortcut)
QShortcut(const QKeySequence &key, QObject *parent, const QObject *context, Functor functor, Qt::ShortcutContext shortcutContext = Qt::WindowShortcut)
(since 6.0) QShortcut(QKeySequence::StandardKey key, QObject *parent, const QObject *context, Functor functor, FunctorAmbiguous functorAmbiguous, Qt::ShortcutContext shortcutContext = Qt::WindowShortcut)
QShortcut(const QKeySequence &key, QObject *parent, const QObject *context, Functor functor, FunctorAmbiguous functorAmbiguous, Qt::ShortcutContext shortcutContext = Qt::WindowShortcut)
(since 6.0) QShortcut(QKeySequence::StandardKey key, QObject *parent, const QObject *context1, Functor functor, const QObject *context2, FunctorAmbiguous functorAmbiguous, Qt::ShortcutContext shortcutContext = Qt::WindowShortcut)
QShortcut(const QKeySequence &key, QObject *parent, const QObject *context1, Functor functor, const QObject *context2, FunctorAmbiguous functorAmbiguous, Qt::ShortcutContext shortcutContext = Qt::WindowShortcut)
virtual ~QShortcut()
bool autoRepeat() const
Qt::ShortcutContext context() const
bool isEnabled() const
QKeySequence key() const
(since 6.0) QList<QKeySequence> keys() const
QWidget *parentWidget() const
void setAutoRepeat(bool on)
void setContext(Qt::ShortcutContext context)
void setEnabled(bool enable)
void setKey(const QKeySequence &key)
(since 6.0) void setKeys(QKeySequence::StandardKey key)
(since 6.0) void setKeys(const QList<QKeySequence> &keys)
void setWhatsThis(const QString &text)
QString whatsThis() const

Señales

Descripción detallada

La clase QShortcut permite asociar atajos de teclado al mecanismo de señales y ranuras de Qt, de modo que los objetos puedan recibir una notificación cuando se ejecute un atajo. El atajo se puede configurar para que contenga todas las pulsaciones de teclas necesarias para definir un atajo de teclado, incluidos los estados de las teclas modificadoras, como Shift, Ctrl y Alt.

En las aplicaciones con widgets, ciertos widgets pueden utilizar el símbolo «&» delante de un carácter. Esto creará automáticamente un mnemónico (un atajo) para ese carácter; por ejemplo, «E&xit» creará el atajo Alt+X (utiliza «&&» para mostrar el símbolo «&» real). El widget puede interpretar y ejecutar una acción al pulsar un atajo determinado. En X11, el símbolo «&» no se muestra y el carácter aparece subrayado. En Windows, los atajos no suelen mostrarse hasta que el usuario pulsa la tecla « Alt », aunque se trata de una configuración que el usuario puede modificar. En Mac, los atajos están desactivados por defecto. Llama a qt_set_sequence_auto_mnemonic() para activarlos. Sin embargo, dado que los atajos mnemónicos no se ajustan a las directrices de Aqua, Qt no mostrará el carácter del atajo subrayado.

Para las aplicaciones que utilizan menús, puede resultar más cómodo utilizar las funciones de ayuda que ofrece la clase ` QMenu ` para asignar atajos de teclado a los elementos del menú a medida que se crean. Como alternativa, los atajos se pueden asociar a otros tipos de acciones en la clase ` QAction `.

La forma más sencilla de crear un atajo para un widget concreto es construirlo con una secuencia de teclas. Por ejemplo:

shortcut = new QShortcut(QKeySequence(tr("Ctrl+O", "File|Open")),
                        parent);

Cuando el usuario pulsa la secuencia de teclas key sequence correspondiente a un atajo determinado, se emite la señal activated() del atajo. (En caso de ambigüedad, se emite la señal activatedAmbiguously().) El bucle de eventos de Qt «escucha» un atajo cuando el widget padre del atajo está recibiendo eventos.

La secuencia de teclas de un atajo se puede configurar con setKey() y recuperar con key(). Un atajo se puede activar o desactivar con setEnabled(), y se le puede asignar un texto de ayuda del tipo «¿Qué es esto?» con setWhatsThis().

Véanse también QShortcutEvent, QKeySequence y QAction.

Documentación de propiedades

autoRepeat : bool

Esta propiedad determina si el atajo de teclado puede repetirse automáticamente

Si el valor es «true», el atajo se repetirá automáticamente mientras se mantenga pulsada la combinación de teclas, siempre que la repetición automática del teclado esté habilitada en el sistema. El valor por defecto es «true».

Funciones de acceso:

bool autoRepeat() const
void setAutoRepeat(bool on)

context : Qt::ShortcutContext

Esta propiedad define el contexto en el que el atajo es válido

El contexto de un atajo determina en qué circunstancias se permite su activación. El contexto normal es Qt::WindowShortcut, lo que permite que el atajo se active si el elemento padre (el widget que contiene el atajo) es un subwidget de la ventana activa de nivel superior.

Por defecto, esta propiedad está establecida en Qt::WindowShortcut.

Funciones de acceso:

Qt::ShortcutContext context() const
void setContext(Qt::ShortcutContext context)

enabled : bool

Esta propiedad se mantiene independientemente de si el atajo está activado

Un atajo activado emite la señal « activated()» o « activatedAmbiguously()» cuando se produce un evento « QShortcutEvent » que coincida con la secuencia « key()» del atajo.

Si la aplicación se encuentra en modo « WhatsThis », el atajo no emitirá las señales, sino que mostrará el texto «¿Qué es esto?».

Por defecto, esta propiedad está configurada como « true ».

Funciones de acceso:

bool isEnabled() const
void setEnabled(bool enable)

Véase también « whatsThis ».

key : QKeySequence

Esta propiedad contiene la secuencia de teclas de acceso rápido

Se trata de una secuencia de teclas con una combinación opcional de Shift, Ctrl y Alt. La secuencia de teclas puede especificarse de varias formas:

setKey(0);                  // no signal emitted
setKey(QKeySequence());     // no signal emitted
setKey(0x3b1);              // Greek letter alpha
setKey(Qt::Key_D);              // 'd', e.g. to delete
setKey('q');                // 'q', e.g. to quit
setKey(Qt::CTRL | Qt::Key_P);       // Ctrl+P, e.g. to print document
setKey(tr("Ctrl+P"));           // Ctrl+P, e.g. to print document

Por defecto, esta propiedad contiene una secuencia de teclas vacía.

Funciones de Access:

QKeySequence key() const
void setKey(const QKeySequence &key)

Documentación de funciones de miembro

[explicit] QShortcut::QShortcut(QObject *parent)

Crea un objeto QShortcut para el ` parent`, que debe ser un ` QWindow ` o un ` QWidget`.

Dado que no se ha especificado ninguna secuencia de teclas de acceso rápido, el acceso rápido no emitirá ninguna señal.

Véase también setKey().

[explicit, since 6.0] QShortcut::QShortcut(QKeySequence::StandardKey standardKey, QObject *parent, const char *member = nullptr, const char *ambiguousMember = nullptr, Qt::ShortcutContext context = Qt::WindowShortcut)

Crea un objeto QShortcut para el ` parent`, que debe ser un ` QWindow ` o un ` QWidget`.

El atajo actúa sobre su elemento padre, a la espera de eventos « QShortcutEvent» que coincidan con el « standardKey ». Dependiendo de la ambigüedad del evento, el atajo llamará a la función « member » o a la función « ambiguousMember », si la pulsación de tecla se produjo dentro del « context » del atajo.

Esta función se introdujo en Qt 6.0.

[explicit] QShortcut::QShortcut(const QKeySequence &key, QObject *parent, const char *member = nullptr, const char *ambiguousMember = nullptr, Qt::ShortcutContext context = Qt::WindowShortcut)

Crea un objeto QShortcut para el parent, que debe ser un QWindow o un QWidget.

El atajo actúa sobre su elemento padre, a la espera de eventos « QShortcutEvent» que coincidan con la secuencia « key ». Dependiendo de la ambigüedad del evento, el atajo llamará a la función « member » o a la función « ambiguousMember », si la pulsación de tecla se produjo dentro del « context » del atajo.

[since 6.0] template <typename Functor> QShortcut::QShortcut(QKeySequence::StandardKey key, QObject *parent, Functor functor, Qt::ShortcutContext shortcutContext = Qt::WindowShortcut)

Este es un constructor de conveniencia de QShortcut que conecta la señal « activated()» del atajo con « functor ».

Se trata de una función sobrecargada.

Esta función se introdujo en Qt 6.0.

template <typename Functor> QShortcut::QShortcut(const QKeySequence &key, QObject *parent, Functor functor, Qt::ShortcutContext shortcutContext = Qt::WindowShortcut)

Este es un constructor de conveniencia de QShortcut que conecta la señal activated() del atajo con la señal functor.

Se trata de una función sobrecargada.

[since 6.0] template <typename Functor> QShortcut::QShortcut(QKeySequence::StandardKey key, QObject *parent, const QObject *context, Functor functor, Qt::ShortcutContext shortcutContext = Qt::WindowShortcut)

Este es un constructor de conveniencia de QShortcut que conecta la señal « activated()» del atajo con « functor ».

functor puede ser un puntero a una función miembro del objeto context.

Si el objeto ` context ` se destruye, no se llamará a ` functor `.

Esta es una función sobrecargada.

Esta función se introdujo en Qt 6.0.

template <typename Functor> QShortcut::QShortcut(const QKeySequence &key, QObject *parent, const QObject *context, Functor functor, Qt::ShortcutContext shortcutContext = Qt::WindowShortcut)

Este es un constructor de conveniencia de QShortcut que conecta la señal « activated()» del atajo con « functor ».

functor puede ser un puntero a una función miembro del objeto context.

Si el objeto ` context ` se destruye, no se llamará a ` functor `.

Esta es una función sobrecargada.

[since 6.0] template <typename Functor, typename FunctorAmbiguous> QShortcut::QShortcut(QKeySequence::StandardKey key, QObject *parent, const QObject *context, Functor functor, FunctorAmbiguous functorAmbiguous, Qt::ShortcutContext shortcutContext = Qt::WindowShortcut)

Este es un constructor de conveniencia de QShortcut que conecta la señal « activated()» del atajo a « functor » y la señal « activatedAmbiguously()» a « functorAmbiguous ».

functor y functorAmbiguous pueden ser un puntero a una función miembro del objeto context.

Si se destruye el objeto context, no se llamarán las funciones functor ni functorAmbiguous.

Esta es una función sobrecargada.

Esta función se introdujo en Qt 6.0.

template <typename Functor, typename FunctorAmbiguous> QShortcut::QShortcut(const QKeySequence &key, QObject *parent, const QObject *context, Functor functor, FunctorAmbiguous functorAmbiguous, Qt::ShortcutContext shortcutContext = Qt::WindowShortcut)

Este es un constructor de conveniencia de QShortcut que conecta la señal « activated()» del atajo a « functor » y la señal « activatedAmbiguously()» a « functorAmbiguous ».

functor y functorAmbiguous pueden ser un puntero a una función miembro del objeto context.

Si se destruye el objeto context, no se llamarán functor ni functorAmbiguous.

Esta es una función sobrecargada.

[since 6.0] template <typename Functor, typename FunctorAmbiguous> QShortcut::QShortcut(QKeySequence::StandardKey key, QObject *parent, const QObject *context1, Functor functor, const QObject *context2, FunctorAmbiguous functorAmbiguous, Qt::ShortcutContext shortcutContext = Qt::WindowShortcut)

Este es un constructor de conveniencia de QShortcut que conecta la señal « activated()» del atajo a « functor » y la señal « activatedAmbiguously()» a « functorAmbiguous ».

functor puede ser un puntero a una función miembro del objeto context1. functorAmbiguous puede ser un puntero a una función miembro del objeto context2.

Si se destruye el objeto ` context1 `, no se llamará a ` functor `. Si se destruye el objeto ` context2 `, no se llamará a ` functorAmbiguous `.

Esta es una función sobrecargada.

Esta función se introdujo en Qt 6.0.

template <typename Functor, typename FunctorAmbiguous> QShortcut::QShortcut(const QKeySequence &key, QObject *parent, const QObject *context1, Functor functor, const QObject *context2, FunctorAmbiguous functorAmbiguous, Qt::ShortcutContext shortcutContext = Qt::WindowShortcut)

Este es un constructor de conveniencia de QShortcut que conecta la señal « activated()» del atajo con « functor » y la señal « activatedAmbiguously()» con « functorAmbiguous ».

functor puede ser un puntero a una función miembro del objeto context1. functorAmbiguous puede ser un puntero a una función miembro del objeto context2.

Si se destruye el objeto context1, no se llamará a functor. Si se destruye el objeto context2, no se llamará a functorAmbiguous.

Esta es una función sobrecargada.

[virtual noexcept] QShortcut::~QShortcut()

Elimina el acceso directo.

[signal] void QShortcut::activated()

Esta señal se emite cuando el usuario pulsa la secuencia de teclas del atajo.

Véase también activatedAmbiguously().

[signal] void QShortcut::activatedAmbiguously()

Cuando se teclea una secuencia de teclas en el teclado, se considera ambigua siempre que coincida con el inicio de más de un atajo.

Cuando se completa la secuencia de teclas de un atajo, se emite la señal activatedAmbiguously() si la secuencia sigue siendo ambigua (es decir, si coincide con el inicio de uno o más atajos adicionales). En este caso, no se emite la señal activated().

Véase también ` activated()`.

[since 6.0] QList<QKeySequence> QShortcut::keys() const

Devuelve la lista de secuencias de teclas que activan este atajo.

Esta función se introdujo en Qt 6.0.

Véase también key y setKeys().

QWidget *QShortcut::parentWidget() const

Devuelve el widget padre del acceso directo.

[since 6.0] void QShortcut::setKeys(QKeySequence::StandardKey key)

Establece los disparadores para que coincidan con la clave estándar « key ».

Esta función se introdujo en Qt 6.0.

Véase también key y keys().

[since 6.0] void QShortcut::setKeys(const QList<QKeySequence> &keys)

Establece « keys » como la lista de secuencias de teclas que activan el atajo.

Esta función se introdujo en Qt 6.0.

Véase también key y keys().

void QShortcut::setWhatsThis(const QString &text)

Establece el texto de ayuda «¿Qué es esto?» del atajo text.

El texto se mostrará cuando una aplicación de widget se encuentre en el modo «¿Qué es esto?» y el usuario introduzca la secuencia de teclas de acceso rápido key().

Para configurar la ayuda «¿Qué es esto?» en un elemento de menú (con o sin tecla de acceso rápido), configura la ayuda en la acción del elemento.

Por defecto, el texto de ayuda es una cadena vacía.

Esta función no tiene ningún efecto en aplicaciones que no utilicen widgets.

Véanse también whatsThis(), QWhatsThis::inWhatsThisMode() y QAction::setWhatsThis().

QString QShortcut::whatsThis() const

Devuelve el texto de ayuda «¿Qué es esto?» del atajo.

Véase también setWhatsThis().

© 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.