QKeySequence Class
La clase QKeySequence encapsula una secuencia de teclas tal y como se utiliza en los atajos de teclado. Más información...
| Encabezado: | #include <QKeySequence> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Gui) target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake: | QT += gui |
- Lista de todos los miembros, incluidos los heredados
- QKeySequence forma parte de las clases compartidas implícitamente.
Tipos públicos
| enum | SequenceFormat { NativeText, PortableText } |
| enum | SequenceMatch { NoMatch, PartialMatch, ExactMatch } |
| enum | StandardKey { AddTab, Back, Backspace, Bold, Close, …, Cancel } |
Funciones públicas
| QKeySequence() | |
| QKeySequence(QKeySequence::StandardKey key) | |
| QKeySequence(const QString &key, QKeySequence::SequenceFormat format = NativeText) | |
| QKeySequence(QKeyCombination k1, QKeyCombination k2 = QKeyCombination::fromCombined(0), QKeyCombination k3 = QKeyCombination::fromCombined(0), QKeyCombination k4 = QKeyCombination::fromCombined(0)) | |
| QKeySequence(int k1, int k2 = 0, int k3 = 0, int k4 = 0) | |
| QKeySequence(const QKeySequence &keysequence) | |
| ~QKeySequence() | |
| int | count() const |
| bool | isEmpty() const |
| QKeySequence::SequenceMatch | matches(const QKeySequence &seq) const |
| void | swap(QKeySequence &other) |
| QString | toString(QKeySequence::SequenceFormat format = PortableText) const |
| operator QVariant() const | |
| bool | operator!=(const QKeySequence &other) const |
| bool | operator<(const QKeySequence &other) const |
| bool | operator<=(const QKeySequence &other) const |
| QKeySequence & | operator=(QKeySequence &&other) |
| QKeySequence & | operator=(const QKeySequence &other) |
| bool | operator==(const QKeySequence &other) const |
| bool | operator>(const QKeySequence &other) const |
| bool | operator>=(const QKeySequence &other) const |
| QKeyCombination | operator[](uint index) const |
Miembros públicos estáticos
| QKeySequence | fromString(const QString &str, QKeySequence::SequenceFormat format = PortableText) |
| QList<QKeySequence> | keyBindings(QKeySequence::StandardKey key) |
| QList<QKeySequence> | listFromString(const QString &str, QKeySequence::SequenceFormat format = PortableText) |
| QString | listToString(const QList<QKeySequence> &list, QKeySequence::SequenceFormat format = PortableText) |
| QKeySequence | mnemonic(const QString &text) |
Elementos no miembros relacionados
| size_t | qHash(const QKeySequence &key, size_t seed = 0) |
| void | qt_set_sequence_auto_mnemonic(bool b) |
| QDataStream & | operator<<(QDataStream &stream, const QKeySequence &sequence) |
| QDataStream & | operator>>(QDataStream &stream, QKeySequence &sequence) |
Descripción detallada
En su forma más habitual, 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 objetos ` QAction ` para especificar qué atajos de teclado pueden utilizarse para activar acciones.
Las secuencias de teclas pueden crearse para su uso como atajos de teclado de tres formas diferentes:
- Para los atajos estándar, se puede utilizar un objeto ` standard key ` para solicitar la secuencia de teclas específica de la plataforma asociada a cada atajo.
- Para los atajos personalizados, se pueden utilizar cadenas legibles para el usuario, como «Ctrl+X», que pueden traducirse a los atajos adecuados para usuarios de diferentes idiomas. Las traducciones se realizan en el contexto «QShortcut ».
- En el caso de los atajos codificados de forma fija, se pueden especificar códigos de tecla enteros mediante una combinación de valores definidos por los valores de enumeración Qt::Key y Qt::KeyboardModifier. Cada código de tecla 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); // deprecatedTen en cuenta que, en el caso de las letras, no importa si se utilizan mayúsculas o minúsculas 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, para otras teclas, el uso de Shift como tecla modificadora adicional no especificada puede generar confusión entre los usuarios de una aplicación cuyos teclados tengan distribuciones diferentes a las utilizadas por los desarrolladores. Consulte la sección « Keyboard Layout Issues » más abajo para obtener más detalles.
Es preferible utilizar atajos estándar siempre que sea posible. Al crear secuencias de teclas para atajos no estándar, se deben utilizar cadenas legibles para el usuario en lugar de valores enteros codificados de forma fija.
El objeto `QKeySequence` se puede serializar en cadenas legibles para el usuario mediante la función ` toString()`.
Una forma alternativa de especificar códigos de teclas codificados de forma fija es utilizar el punto de código Unicode del carácter; por ejemplo, «A» proporciona la misma secuencia de teclas que Qt::Key_A.
Nota: En las plataformas de Apple, las referencias a «Ctrl», Qt::CTRL, Qt::Key_Control y Qt::ControlModifier corresponden a las teclas Command del teclado de Macintosh, y las referencias a «Meta», Qt::META, Qt::Key_Meta y Qt::MetaModifier corresponden a las teclas Control. En la práctica, los desarrolladores pueden utilizar las mismas descripciones de atajos en todas las plataformas, y sus aplicaciones funcionarán automáticamente como se espera en las plataformas de Apple.
Atajos estándar
QKeySequence define numerosas secuencias de teclas ( standard keyboard shortcuts ) para reducir el esfuerzo necesario a la hora de configurar acciones en una aplicación típica. La tabla siguiente muestra algunas secuencias de teclas comunes que suelen utilizarse para estos atajos estándar en aplicaciones de cuatro plataformas muy extendidas. Tenga en cuenta que, en las plataformas de Apple, el valor « Ctrl » corresponde a las teclas « Command » del teclado de Macintosh, y el valor « Meta » corresponde a las teclas « Control ».
| StandardKey | Windows | Plataformas de Apple | KDE Plasma | GNOME |
|---|---|---|---|---|
| HelpContents | F1 | Ctrl+? | F1 | F1 |
| WhatsThis | Mayús+F1 | Mayús+F1 | Mayús+F1 | Mayús+F1 |
| Abrir | Ctrl+O | Ctrl+O | Ctrl+O | Ctrl+O |
| Cerrar | Ctrl+F4, Ctrl+W | Ctrl+W, Ctrl+F4 | Ctrl+W | Ctrl+W |
| Guardar | Ctrl+S | Ctrl+S | Ctrl+S | Ctrl+S |
| Salir | Ctrl+Q | Ctrl+Q | Ctrl+Q | |
| SaveAs | Ctrl+Mayús+S | Ctrl+Mayús+S | Ctrl+Mayús+S | Ctrl+Mayús+S |
| Nuevo | Ctrl+N | Ctrl+N | Ctrl+N | Ctrl+N |
| Suprimir | Supr | Suprimir hacia delante, Meta+D | Supr, Ctrl+D | Supr, Ctrl+D |
| Cortar | Ctrl+X, Mayús+Supr | Ctrl+X, Meta+K | Ctrl+X, F20, Mayús+Supr | Ctrl+X, F20, Mayús+Supr |
| Copiar | Ctrl+C, Ctrl+Ins | Ctrl+C | Ctrl+C, F16, Ctrl+Ins | Ctrl+C, F16, Ctrl+Ins |
| Pegar | Ctrl+V, Mayús+Ins | Ctrl+V, Meta+Y | Ctrl+V, F18, Mayús+Ins | Ctrl+V, F18, Mayús+Ins |
| Preferencias | Ctrl+, | Ctrl+Mayús+, | ||
| Deshacer | Ctrl+Z, Alt+Retroceso | Ctrl+Z | Ctrl+Z, F14 | Ctrl+Z, F14 |
| Rehacer | Ctrl+Y, Mayús+Ctrl+Z, Alt+Mayús+Retroceso | Ctrl+Mayús+Z | Ctrl+Mayús+Z | Ctrl+Mayús+Z |
| Atrás | Alt+Izq., Retroceso | Ctrl+[ | Alt+Izq. | Alt+Izq. |
| Adelante | Alt+Derecha, Mayús+Retroceso | Ctrl+] | Alt+Derecha | Alt+Derecha |
| Actualizar | F5 | F5 | F5 | Ctrl+R, F5 |
| ZoomIn | Ctrl+Más | Ctrl+Más | Ctrl+Más | Ctrl+Más |
| ZoomOut | Ctrl+Menos | Ctrl+Menos | Ctrl+Menos | Ctrl+Menos |
| FullScreen | F11, Alt+Intro | Ctrl+Meta+F | F11, Ctrl+Mayús+F | Ctrl+F11 |
| Imprimir | Ctrl+P | Ctrl+P | Ctrl+P | Ctrl+P |
| AddTab | Ctrl+T | Ctrl+T | Ctrl+Mayús+N, Ctrl+T | Ctrl+T |
| NextChild | Ctrl+Tab, Adelante, Ctrl+F6 | Ctrl+}, Adelante, Ctrl+Tab | Ctrl+Tab, Adelante, Ctrl+Coma | Ctrl+Tab, Adelante |
| PreviousChild | Ctrl+Mayús+Tab, Atrás, Ctrl+Mayús+F6 | Ctrl+{, Atrás, Ctrl+Mayús+Tab | Ctrl+Mayús+Tab, Atrás, Ctrl+Punto | Ctrl+Mayús+Tab, Atrás |
| Buscar | Ctrl+F | Ctrl+F | Ctrl+F | Ctrl+F |
| FindNext | F3, Ctrl+G | Ctrl+G | F3 | Ctrl+G, F3 |
| FindPrevious | Mayús+F3, Ctrl+Mayús+G | Ctrl+Mayús+G | Mayús+F3 | Ctrl+Mayús+G, Mayús+F3 |
| Reemplazar | Ctrl+H | (ninguno) | Ctrl+R | Ctrl+H |
| SelectAll | Ctrl+A | Ctrl+A | Ctrl+A | Ctrl+A |
| Deseleccionar | Ctrl+Mayús+A | Ctrl+Mayús+A | ||
| Negrita | Ctrl+B | Ctrl+B | Ctrl+B | Ctrl+B |
| Cursiva | Ctrl+I | Ctrl+I | Ctrl+I | Ctrl+I |
| Subrayado | Ctrl+U | Ctrl+U | Ctrl+U | Ctrl+U |
| MoveToNextChar | Derecha | Derecha, Meta+F | Derecha | Derecha |
| MoveToPreviousChar | Izquierda | Izquierda, Meta+B | Izquierda | Izquierda |
| MoveToNextWord | Ctrl+Derecha | Alt+Derecha | Ctrl+Derecha | Ctrl+Derecha |
| MoveToPreviousWord | Ctrl+Izquierda | Alt+Izquierda | Ctrl+Izquierda | Ctrl+Izquierda |
| MoveToNextLine | Abajo | Abajo, Meta+N | Abajo | Abajo |
| MoveToPreviousLine | Arriba | Arriba, Meta+P | Arriba | Arriba |
| MoveToNextPage | AvPág | AvPág, Alt+AvPág, Meta+Abajo, Meta+AvPág, Meta+V | AvPág | AvPág |
| MoveToPreviousPage | RePág | RePág, Alt+RePág, Meta+Arriba, Meta+RePág | RePág | Re Pág |
| MoveToStartOfLine | Inicio | Ctrl+Izq., Meta+Izq. | Inicio | Inicio |
| MoveToEndOfLine | Fin | Ctrl+Derecha, Meta+Derecha | Fin, Ctrl+E | Fin, Ctrl+E |
| MoveToStartOfBlock | (ninguno) | Alt+Arriba, Meta+A | (ninguno) | (ninguno) |
| MoveToEndOfBlock | (ninguno) | Alt+Abajo, Meta+E | (ninguno) | (ninguno) |
| MoveToStartOfDocument | Ctrl+Inicio | Ctrl+Arriba, Inicio | Ctrl+Inicio | Ctrl+Inicio |
| MoveToEndOfDocument | Ctrl+Fin | Ctrl+Abajo, Fin | Ctrl+Fin | Ctrl+Fin |
| SelectNextChar | Mayús+Derecha | Mayús+Derecha | Mayús+Derecha | Mayús+Derecha |
| SelectPreviousChar | Mayús+Izq | Mayús+Izquierda | Mayús + Izquierda | Mayús+Izq |
| SelectNextWord | Ctrl+Mayús+Derecha | Alt+Mayús+Derecha | Ctrl+Mayús+Derecha | Ctrl+Mayús+Derecha |
| SelectPreviousWord | Ctrl+Mayús+Izq. | Alt+Mayús+Izquierda | Ctrl+Mayús+Izquierda | Ctrl+Mayús+Izquierda |
| SelectNextLine | Mayús+Abajo | Mayús+Abajo | Mayús+Abajo | Mayús+Abajo |
| SelectPreviousLine | Mayús + Arriba | Mayús+Arriba | Mayús+Arriba | Mayús+Arriba |
| SelectNextPage | Mayús + Av Pág | Mayús+AvPág | Mayús+AvPág | Mayús+AvPág |
| SelectPreviousPage | Mayús+Re Pág | Mayús+RePág | Mayús+RePág | Mayús + Re Pág |
| SelectStartOfLine | Mayús+Inicio | Ctrl+Mayús+Izq. | Mayús+Inicio | Mayús+Inicio |
| SelectEndOfLine | Mayús+Fin | Ctrl+Mayús+Derecha | Mayús+Fin | Mayús+Fin |
| SelectStartOfBlock | (ninguno) | Alt+Mayús+Arriba, Meta+Mayús+A | (ninguno) | (ninguno) |
| SelectEndOfBlock | (ninguno) | Alt+Mayús+Abajo, Meta+Mayús+E | (ninguno) | (ninguno) |
| SelectStartOfDocument | Ctrl+Mayús+Inicio | Ctrl+Mayús+Arriba, Mayús+Inicio | Ctrl+Mayús+Inicio | Ctrl+Mayús+Inicio |
| SelectEndOfDocument | Ctrl+Mayús+Fin | Ctrl+Mayús+Flecha abajo, Mayús+Fin | Ctrl+Mayús+Fin | Ctrl+Mayús+Fin |
| DeleteStartOfWord | Ctrl+Retroceso | Alt+Retroceso | Ctrl+Retroceso | Ctrl+Retroceso |
| DeleteEndOfWord | Ctrl+Supr | (ninguna) | Ctrl+Supr | Ctrl+Supr |
| DeleteEndOfLine | (ninguno) | (ninguno) | Ctrl+K | Ctrl+K |
| DeleteCompleteLine | (ninguno) | (ninguno) | Ctrl+U | Ctrl+U |
| InsertParagraphSeparator | Intro | Intro | Intro | Intro |
| InsertLineSeparator | Mayús+Intro | Meta+Intro, Meta+O | Mayús + Intro | Mayús+Intro |
| Retroceso | (ninguno) | Suprimir, Meta+H | (ninguno) | (ninguna) |
| Cancelar | Esc | Esc, Ctrl+. | Esc | Esc |
Ten en cuenta que, dado que las secuencias de teclas utilizadas para los atajos estándar varían según la plataforma, debes probar tus atajos en cada una de ellas para asegurarte de que no asignas involuntariamente la misma secuencia de teclas a varias acciones.
Problemas con la distribución del teclado
Los desarrolladores eligen muchas especificaciones de secuencias de teclas basándose en la distribució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 ciertos símbolos solo pueden introducirse con la ayuda de teclas modificadoras en determinadas distribuciones de teclado, las secuencias de teclas destinadas a utilizarse con una distribución concreta pueden asignarse a una tecla diferente, no asignarse a ninguna tecla o requerir el uso de una tecla modificadora adicional en otras distribuciones de teclado.
Por ejemplo, los atajos « Ctrl plus » y « Ctrl minus » se utilizan a menudo 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 están contiguas en el teclado, pero aún así podrán activar ambos atajos sin necesidad de pulsar la tecla « Shift ». Sin embargo, los usuarios con teclados británicos tendrán que mantener pulsada la tecla « Shift » para introducir el símbolo « + », lo que hace que el atajo sea, en la práctica, el mismo que «Ctrl+Shift+=».
Aunque algunos desarrolladores podrían recurrir a especificar de forma completa todos los modificadores que utilizan en sus teclados para activar un atajo, esto también provocará un comportamiento inesperado para los usuarios de diferentes distribuciones de teclado.
Por ejemplo, un desarrollador que utilice un teclado británico podría 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 un teclado noruego, para acceder a la tecla = hay que utilizar la tecla Shift, lo que hace que el atajo necesario sea, en la práctica, Ctrl Shift Shift = (una combinación de teclas imposible).
En consecuencia, tanto las cadenas legibles para el usuario como los códigos de teclas codificados de forma rígida pueden resultar problemáticos a la hora de especificar una secuencia de teclas que se pueda utilizar en una variedad de distribuciones de teclado diferentes. Solo el uso de « standard shortcuts » garantiza que el usuario pueda utilizar los atajos que el desarrollador tenía previsto.
A pesar de ello, podemos abordar este problema asegurándonos de que se utilicen cadenas legibles para el usuario, lo que permite realizar traducciones de las secuencias de teclas para usuarios de diferentes idiomas. Este enfoque dará buenos resultados para los usuarios cuyos teclados tengan la distribución más habitual para el idioma que utilizan.
Secuencias de teclas al estilo de GNU Emacs
Se pueden crear secuencias de teclas similares a las utilizadas en GNU Emacs, que admiten hasta cuatro códigos de tecla, utilizando el constructor de argumentos múltiples o pasando una cadena legible para el usuario con secuencias de teclas separadas por comas.
Por ejemplo, la secuencia de teclas « Ctrl X » seguida de « Ctrl C » puede especificarse de 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); // deprecatedAdvertencia: Se debe haber creadouna instancia de ` QApplication ` antes de crear un `QKeySequence`; de lo contrario, la aplicación podría bloquearse.
Véase también QShortcut.
Documentación sobre los tipos de miembros
enum QKeySequence::SequenceFormat
| Constante | Valor | Descripción |
|---|---|---|
QKeySequence::NativeText | 0 | La secuencia de teclas como una cadena específica de la plataforma. Esto significa que se mostrará traducida y que, en las plataformas de Apple, se parecerá a una secuencia de teclas de la barra de menús. Esta enumeración se utiliza mejor cuando se desea mostrar la cadena al usuario. |
QKeySequence::PortableText | 1 | La secuencia de teclas se proporciona en un formato «portable», adecuado para leer y escribir en un archivo. En muchos casos, tendrá un aspecto similar al texto nativo de Windows y X11. |
enum QKeySequence::SequenceMatch
| Constante | Valor | Descripción |
|---|---|---|
QKeySequence::NoMatch | 0 | Las secuencias de teclas son diferentes; ni siquiera coinciden parcialmente. |
QKeySequence::PartialMatch | 1 | Las secuencias de claves coinciden parcialmente, pero no son iguales. |
QKeySequence::ExactMatch | 2 | Las secuencias de claves son idénticas. |
enum QKeySequence::StandardKey
Esta enumeración representa las combinaciones de teclas estándar. Se pueden utilizar para asignar atajos de teclado específicos de cada plataforma a un ` QAction`.
Ten en cuenta que las combinaciones de teclas dependen de la plataforma. Los atajos asignados actualmente se pueden consultar mediante keyBindings().
| Constante | Valor | Descripción |
|---|---|---|
QKeySequence::AddTab | 19 | Añadir una nueva pestaña. |
QKeySequence::Back | 13 | Retroceder. |
QKeySequence::Backspace | 69 | Borrar el carácter anterior. |
QKeySequence::Bold | 27 | Poner el texto en negrita. |
QKeySequence::Close | 4 | Cerrar documento/pestaña. |
QKeySequence::Copy | 9 | Copiar. |
QKeySequence::Cut | 8 | Cortar. |
QKeySequence::Delete | 7 | Eliminar. |
QKeySequence::DeleteEndOfLine | 60 | Eliminar el final de la línea. |
QKeySequence::DeleteEndOfWord | 59 | Eliminar la palabra situada al final del cursor. |
QKeySequence::DeleteStartOfWord | 58 | Eliminar el inicio de una palabra hasta el cursor. |
QKeySequence::DeleteCompleteLine | 68 | Borrar toda la línea. |
QKeySequence::Find | 22 | Buscar en el documento. |
QKeySequence::FindNext | 23 | Buscar el siguiente resultado. |
QKeySequence::FindPrevious | 24 | Buscar el resultado anterior. |
QKeySequence::Forward | 14 | Avanzar. |
QKeySequence::HelpContents | 1 | Abrir el índice de ayuda. |
QKeySequence::InsertLineSeparator | 62 | Insertar una nueva línea. |
QKeySequence::InsertParagraphSeparator | 61 | Insertar un nuevo párrafo. |
QKeySequence::Italic | 28 | Texto en cursiva. |
QKeySequence::MoveToEndOfBlock | 41 | Mover el cursor al final del bloque. Este atajo solo se utiliza en plataformas de Apple. |
QKeySequence::MoveToEndOfDocument | 43 | Mover el cursor al final del documento. |
QKeySequence::MoveToEndOfLine | 39 | Mover el cursor al final de la línea. |
QKeySequence::MoveToNextChar | 30 | Mover el cursor al siguiente carácter. |
QKeySequence::MoveToNextLine | 34 | Mueve el cursor a la línea siguiente. |
QKeySequence::MoveToNextPage | 36 | Mueve el cursor a la página siguiente. |
QKeySequence::MoveToNextWord | 32 | Mueve el cursor a la palabra siguiente. |
QKeySequence::MoveToPreviousChar | 31 | Mueve el cursor al carácter anterior. |
QKeySequence::MoveToPreviousLine | 35 | Mueve el cursor a la línea anterior. |
QKeySequence::MoveToPreviousPage | 37 | Mueve el cursor a la página anterior. |
QKeySequence::MoveToPreviousWord | 33 | Mueve el cursor a la palabra anterior. |
QKeySequence::MoveToStartOfBlock | 40 | Mueve el cursor al inicio de un bloque. Este atajo solo se utiliza en plataformas de Apple. |
QKeySequence::MoveToStartOfDocument | 42 | Mueve el cursor al inicio del documento. |
QKeySequence::MoveToStartOfLine | 38 | Mueve el cursor al principio de la línea. |
QKeySequence::New | 6 | Crear un nuevo documento. |
QKeySequence::NextChild | 20 | Navegar a la siguiente pestaña o ventana secundaria. |
QKeySequence::Open | 3 | Abrir documento. |
QKeySequence::Paste | 10 | Pegar. |
QKeySequence::Preferences | 64 | Abrir el cuadro de diálogo de preferencias. |
QKeySequence::PreviousChild | 21 | Ir a la pestaña anterior o a la ventana secundaria. |
QKeySequence::Print | 18 | Imprimir el documento. |
QKeySequence::Quit | 65 | Salir de la aplicación. |
QKeySequence::Redo | 12 | Rehacer. |
QKeySequence::Refresh | 15 | Actualizar o recargar el documento actual. |
QKeySequence::Replace | 25 | Buscar y sustituir. |
QKeySequence::SaveAs | 63 | Guardar el documento tras solicitar al usuario un nombre de archivo. |
QKeySequence::Save | 5 | Guardar el documento. |
QKeySequence::SelectAll | 26 | Seleccionar todo el texto. |
QKeySequence::Deselect | 67 | Deseleccionar texto. Desde la versión 5.1 |
QKeySequence::SelectEndOfBlock | 55 | Ampliar la selección hasta el final de un bloque de texto. Este atajo de teclado solo se utiliza en plataformas de Apple. |
QKeySequence::SelectEndOfDocument | 57 | Ampliar la selección hasta el final del documento. |
QKeySequence::SelectEndOfLine | 53 | Ampliar la selección hasta el final de la línea. |
QKeySequence::SelectNextChar | 44 | Ampliar la selección hasta el siguiente carácter. |
QKeySequence::SelectNextLine | 48 | Ampliar la selección hasta la línea siguiente. |
QKeySequence::SelectNextPage | 50 | Ampliar la selección hasta la página siguiente. |
QKeySequence::SelectNextWord | 46 | Ampliar la selección hasta la siguiente palabra. |
QKeySequence::SelectPreviousChar | 45 | Ampliar la selección hasta el carácter anterior. |
QKeySequence::SelectPreviousLine | 49 | Ampliar la selección a la línea anterior. |
QKeySequence::SelectPreviousPage | 51 | Ampliar la selección a la página anterior. |
QKeySequence::SelectPreviousWord | 47 | Ampliar la selección hasta la palabra anterior. |
QKeySequence::SelectStartOfBlock | 54 | Ampliar la selección hasta el inicio de un bloque de texto. Este atajo de teclado solo se utiliza en plataformas de Apple. |
QKeySequence::SelectStartOfDocument | 56 | Ampliar la selección hasta el inicio del documento. |
QKeySequence::SelectStartOfLine | 52 | Ampliar la selección hasta el inicio de la línea. |
QKeySequence::Underline | 29 | Subrayar el texto. |
QKeySequence::Undo | 11 | Deshacer. |
QKeySequence::UnknownKey | 0 | Tecla sin asignar. |
QKeySequence::WhatsThis | 2 | Activar «¿Qué es esto?». |
QKeySequence::ZoomIn | 16 | Acercar la imagen. |
QKeySequence::ZoomOut | 17 | Alejar. |
QKeySequence::FullScreen | 66 | Alternar entre pantalla completa y modo normal. |
QKeySequence::Cancel | 70 | Cancelar la operación actual. |
Documentación de funciones de miembro
QKeySequence::QKeySequence()
Crea una secuencia de claves vacía.
QKeySequence::QKeySequence(QKeySequence::StandardKey key)
Crea un objeto QKeySequence para la secuencia de teclas dada en key. El resultado dependerá de la plataforma en la que se ejecute actualmente.
El objeto resultante se basará en el primer elemento de la lista de combinaciones de teclas de key.
QKeySequence::QKeySequence(const QString &key, QKeySequence::SequenceFormat format = NativeText)
Crea una secuencia de teclas a partir de la cadena « key », basándose en format.
Por ejemplo, «Ctrl+O» da como resultado CTRL+'O'. Se reconocen las cadenas «Ctrl», «Shift», «Alt» y «Meta», así como sus equivalentes traducidos en el contexto «QShortcut » (utilizando QObject::tr()).
Se pueden introducir hasta cuatro códigos de teclas separándolos con comas, p. ej., «Alt+X,Ctrl+S,Q».
Este constructor se suele utilizar con ` tr()`, de modo que las teclas de acceso rápido puedan sustituirse en las traducciones:
QMenu *file = new QMenu(this);
file->addAction(tr("&Open..."), QKeySequence(tr("Ctrl+O", "File|Open")),
this, &MainWindow::open);Fíjate en el comentario del traductor «Archivo|Abrir». No es en absoluto necesario, pero proporciona algo de contexto al traductor humano.
QKeySequence::QKeySequence(QKeyCombination k1, QKeyCombination k2 = QKeyCombination::fromCombined(0), QKeyCombination k3 = QKeyCombination::fromCombined(0), QKeyCombination k4 = QKeyCombination::fromCombined(0))
Crea una secuencia de claves con un máximo de 4 claves: k1, k2, k3 y k4.
Véase también QKeyCombination.
QKeySequence::QKeySequence(int k1, int k2 = 0, int k3 = 0, int k4 = 0)
Crea una secuencia de claves con un máximo de 4 claves: k1, k2, k3 y k4.
Los códigos de las teclas se enumeran en Qt::Key y pueden combinarse con modificadores (véase Qt::KeyboardModifier), como Qt::ShiftModifier, Qt::ControlModifier, Qt::AltModifier o Qt::MetaModifier.
QKeySequence::QKeySequence(const QKeySequence &keysequence)
Constructor de copia. Crea una copia de ` keysequence`.
[noexcept] QKeySequence::~QKeySequence()
Elimina la secuencia de claves.
int QKeySequence::count() const
Devuelve el número de claves que hay en la secuencia de claves. El máximo es 4.
[static] QKeySequence QKeySequence::fromString(const QString &str, QKeySequence::SequenceFormat format = PortableText)
Devuelve un objeto ` QKeySequence ` a partir de la cadena ` str `, basándose en ` format`.
Véase también toString().
bool QKeySequence::isEmpty() const
Devuelve « true » si la secuencia de claves está vacía; en caso contrario, devuelve «false».
[static] QList<QKeySequence> QKeySequence::keyBindings(QKeySequence::StandardKey key)
Devuelve una lista de combinaciones de teclas para el key especificado. El resultado de llamar a esta función variará en función de la plataforma de destino. El primer elemento de la lista indica el atajo principal para la plataforma especificada. Si el resultado contiene más de un elemento, estos pueden considerarse atajos alternativos en la misma plataforma para el key especificado.
[static] QList<QKeySequence> QKeySequence::listFromString(const QString &str, QKeySequence::SequenceFormat format = PortableText)
Devuelve una lista de « QKeySequence » a partir de la cadena « str », basándose en « format ».
Véase también fromString() y listToString().
[static] QString QKeySequence::listToString(const QList<QKeySequence> &list, QKeySequence::SequenceFormat format = PortableText)
Devuelve una representación en forma de cadena de « list » basada en « format ».
Véanse también toString() y listFromString().
QKeySequence::SequenceMatch QKeySequence::matches(const QKeySequence &seq) const
Busca coincidencias entre la secuencia y seq. Devuelve ExactMatch si la búsqueda tiene éxito, PartialMatch si seq coincide parcialmente, y NoMatch si las secuencias no tienen nada en común. Devuelve NoMatch si seq es más corta.
[static] QKeySequence QKeySequence::mnemonic(const QString &text)
Devuelve la secuencia de teclas de acceso rápido correspondiente al mnemónico de text, o una secuencia de teclas vacía si no se encuentra ningún mnemónico.
Por ejemplo, mnemonic("E&xit") devuelve Qt::ALT+Qt::Key_X, mnemonic("&Quit") devuelve ALT+Key_Q y mnemonic("Quit") devuelve una secuencia vacía QKeySequence.
[noexcept] void QKeySequence::swap(QKeySequence &other)
Intercambia esta secuencia de teclas con « other ». Esta operación es muy rápida y nunca falla.
QString QKeySequence::toString(QKeySequence::SequenceFormat format = PortableText) const
Devuelve una representación en forma de cadena de la secuencia de teclas, según format.
Por ejemplo, el valor Qt::CTRL+Qt::Key_O da como resultado «Ctrl+O». Si la secuencia de teclas tiene varios códigos de tecla, cada uno de ellos se separa mediante comas en la cadena devuelta, como «Alt+X, Ctrl+Y, Z». Las cadenas «Ctrl», «Shift», etc. se traducen utilizando QObject::tr() en el contexto «QShortcut ».
Si la secuencia de teclas no contiene ninguna tecla, se devuelve una cadena vacía.
En plataformas de Apple, la cadena devuelta se asemeja a la secuencia que se muestra en la barra de menús si format es QKeySequence::NativeText; en caso contrario, la cadena utiliza el formato «portable», adecuado para escribir en un archivo.
Véase también fromString().
QKeySequence::operator QVariant() const
Devuelve la secuencia de claves como un QVariant
bool QKeySequence::operator!=(const QKeySequence &other) const
Devuelve « true » si esta secuencia de claves no es igual a la secuencia de claves « other »; en caso contrario, devuelve « false ».
bool QKeySequence::operator<(const QKeySequence &other) const
Proporciona una comparación arbitraria entre esta secuencia de claves y una secuencia de clave other. Lo único que se garantiza es que el operador devuelve un false si ambas secuencias de claves son iguales y que (ks1 < ks2) == !(ks2 < ks1) si las secuencias de claves no son iguales.
Esta función resulta útil en determinadas circunstancias, por ejemplo, si se desea utilizar objetos ` QKeySequence ` como claves en un ` QMap`.
Véanse también operator==(), operator!=(), operator>(), operator<=() y operator>=().
bool QKeySequence::operator<=(const QKeySequence &other) const
Devuelve « true » si esta secuencia de claves es menor o igual que la secuencia de claves « other »; en caso contrario, devuelve « false ».
Véase también operator==(), operator!=(), operator<(), operator>() y operator>=().
[noexcept] QKeySequence &QKeySequence::operator=(QKeySequence &&other)
Asigna « other » a esta instancia de « QKeySequence ». »
QKeySequence &QKeySequence::operator=(const QKeySequence &other)
Operador de asignación. Asigna la secuencia de teclas « other » a este objeto.
bool QKeySequence::operator==(const QKeySequence &other) const
Devuelve « true » si esta secuencia de claves es igual a la secuencia de claves « other »; en caso contrario, devuelve « false ».
bool QKeySequence::operator>(const QKeySequence &other) const
Devuelve « true » si esta secuencia de claves es mayor que la secuencia de claves « other »; en caso contrario, devuelve « false ».
Véase también operator==(), operator!=(), operator<(), operator<=() y operator>=().
bool QKeySequence::operator>=(const QKeySequence &other) const
Devuelve true si esta secuencia de claves es mayor o igual que la secuencia de claves other; en caso contrario, devuelve false.
Véase también operator==(), operator!=(), operator<(), operator>() y operator<=().
QKeyCombination QKeySequence::operator[](uint index) const
Devuelve una referencia al elemento situado en la posición index de la secuencia de claves. Solo se puede utilizar para leer un elemento.
Elementos no miembros relacionados
[noexcept] size_t qHash(const QKeySequence &key, size_t seed = 0)
Devuelve el valor hash de key, utilizando seed como semilla para el cálculo.
void qt_set_sequence_auto_mnemonic(bool b)
Especifica si se deben respetar o no los mnemónicos de los elementos de menú, las etiquetas, etc. En Windows y X11, esta función está activada por defecto; en macOS, está desactivada. Cuando esta función está desactivada (es decir, cuando ` b ` es `false`), ` QKeySequence::mnemonic()` siempre devuelve una cadena vacía.
Nota: Esta función no está declarada en ninguno de los archivos de cabecera de Qt. Para utilizarla en tu aplicación, declara el prototipo de la función antes de llamarla.
Véase también QShortcut.
QDataStream &operator<<(QDataStream &stream, const QKeySequence &sequence)
Escribe la clave « sequence » en « stream ».
Véase también Formato de los operadores de QDataStream.
QDataStream &operator>>(QDataStream &stream, QKeySequence &sequence)
Lee una secuencia de claves del ` stream ` y la introduce en el ` sequence`.
Véase también el formato de los operadores de QDataStream.
© 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.