QKeySequence Class

Descripción Detallada

En su forma más común, una secuencia de teclas describe una combinación de teclas que deben utilizarse juntas para realizar alguna acción. Las secuencias de teclas se utilizan con los objetos QAction para especificar los métodos abreviados de teclado que pueden utilizarse para desencadenar acciones.

Las secuencias de teclas pueden construirse como atajos de teclado de tres formas distintas:

• Para los métodos abreviados estándar, se puede utilizar standard key para solicitar la secuencia de teclas específica de la plataforma asociada a cada método abreviado.
• Para los métodos abreviados personalizados, se pueden utilizar cadenas legibles como "Ctrl+X", que pueden traducirse a los métodos abreviados adecuados para usuarios de distintos idiomas. Las traducciones se realizan en el contexto "QShortcut".
• Para los métodos abreviados codificados, se pueden especificar códigos de tecla enteros con una combinación de valores definidos por los valores enum Qt::Key y Qt::KeyboardModifier. Cada código clave consta de un único valor Qt::Key y cero o más modificadores, como Qt::ShiftModifier, Qt::ControlModifier, Qt::AltModifier y Qt::MetaModifier.

Por ejemplo, Ctrl P podría ser una secuencia utilizada como atajo para imprimir un documento, y puede especificarse de cualquiera de las siguientes formas:

QKeySequence(QKeySequence::Print);
QKeySequence(tr("Ctrl+P"));
QKeySequence(tr("Ctrl+p"));
QKeySequence(Qt::CTRL | Qt::Key_P);
QKeySequence(Qt::CTRL + Qt::Key_P); // deprecated

Tenga en cuenta que, en el caso de las letras, no importa la mayúscula o minúscula utilizada en la cadena de especificación. En los ejemplos anteriores, el usuario no necesita mantener pulsada la tecla Shift para activar un atajo especificado con "Ctrl+P". Sin embargo, en el caso de otras teclas, el uso de Shift como tecla modificadora adicional no especificada puede llevar a confusión a los usuarios de una aplicación cuyos teclados tengan distribuciones diferentes a las utilizadas por los desarrolladores. Para más información, consulte la sección Keyboard Layout Issues.

Es preferible utilizar atajos estándar siempre que sea posible. Al crear secuencias de teclas para métodos abreviados no estándar, debe utilizar cadenas legibles por humanos en lugar de valores enteros codificados.

El objeto QKeySequence se puede serializar en cadenas legibles con la función toString().

Una forma alternativa de especificar códigos de tecla codificados es utilizar el punto de código Unicode del carácter; por ejemplo, "A" proporciona la misma secuencia de teclas que Qt::Key_A.

Atajos estándar

QKeySequence define muchas standard keyboard shortcuts para reducir el esfuerzo necesario al configurar acciones en una aplicación típica. La siguiente tabla muestra algunas secuencias de teclas comunes que se utilizan a menudo para estos accesos directos estándar por aplicaciones en cuatro plataformas ampliamente utilizadas. Tenga en cuenta que en las plataformas Apple, el valor Ctrl corresponde a las teclas Command del teclado Macintosh, y el valor Meta corresponde a las teclas Control.

Ten en cuenta que, dado que las secuencias de teclas utilizadas para los métodos abreviados estándar difieren entre plataformas, debes probar tus métodos abreviados en cada plataforma para asegurarte de que no asignas involuntariamente la misma secuencia de teclas a muchas acciones.

Problemas de distribución del teclado

Los desarrolladores eligen muchas especificaciones de secuencias de teclas basándose en la disposición de determinados tipos de teclado, en lugar de elegir teclas que representen la primera letra del nombre de una acción, como Ctrl S ("Ctrl+S") o Ctrl C ("Ctrl+C"). Además, dado que algunos símbolos sólo pueden introducirse con la ayuda de teclas modificadoras en determinadas distribuciones de teclado, las secuencias de teclas previstas para su uso con una distribución de teclado pueden asignarse a una tecla diferente, no asignarse a ninguna tecla o requerir una tecla modificadora adicional para su uso en diferentes distribuciones de teclado.

Por ejemplo, los métodos abreviados Ctrl plus y Ctrl minus se utilizan a menudo como métodos abreviados para operaciones de zoom en aplicaciones gráficas, y pueden especificarse como "Ctrl++" y "Ctrl+-" respectivamente. Sin embargo, la forma en que se especifican e interpretan estos atajos depende de la distribución del teclado. Los usuarios de teclados noruegos observarán que las teclas + y - no son adyacentes en el teclado, pero podrán activar ambos atajos sin necesidad de pulsar la tecla Shift. Sin embargo, los usuarios de teclados británicos tendrán que mantener pulsada la tecla Shift para introducir el símbolo +, lo que hace que el atajo sea efectivamente el mismo que "Ctrl+Shift+=".

Aunque algunos desarrolladores pueden recurrir a especificar completamente todos los modificadores que utilizan en sus teclados para activar un método abreviado, esto también dará lugar a comportamientos inesperados para los usuarios de diferentes distribuciones de teclado.

Por ejemplo, un desarrollador que utilice un teclado británico puede decidir especificar "Ctrl+Shift+=" como secuencia de teclas para crear un atajo que casualmente se comporte de la misma manera que Ctrl plus. Sin embargo, en el teclado noruego es necesario acceder a la tecla = utilizando la tecla Shift, lo que hace que el atajo requerido sea efectivamente Ctrl Shift Shift = (una combinación de teclas imposible).

Por lo tanto, tanto las cadenas legibles por el ser humano como los códigos de teclas codificados pueden resultar problemáticos a la hora de especificar una secuencia de teclas que se pueda utilizar con diferentes distribuciones de teclado. Sólo el uso de standard shortcuts garantiza que el usuario pueda utilizar los atajos que el desarrollador pretendía.

A pesar de ello, podemos resolver este problema garantizando que se utilicen cadenas legibles por el ser humano, lo que permitirá traducir las secuencias de teclas para usuarios de distintos idiomas. Este enfoque tendrá éxito para los usuarios cuyos teclados tengan la disposición más típica para el idioma que estén utilizando.

Secuencias de teclas estilo GNU Emacs

Se pueden crear secuencias de teclas similares a las utilizadas en GNU Emacs, que permiten hasta cuatro códigos de teclas, utilizando el constructor de argumentos múltiples, o pasando una cadena legible por humanos de secuencias de teclas separadas por comas.

Por ejemplo, la secuencia de teclas, Ctrl X seguida de Ctrl C, puede especificarse utilizando cualquiera de las siguientes formas:

QKeySequence(tr("Ctrl+X, Ctrl+C"));
QKeySequence(Qt::CTRL | Qt::Key_X, Qt::CTRL | Qt::Key_C);
QKeySequence(Qt::CTRL + Qt::Key_X, Qt::CTRL + Qt::Key_C); // deprecated