QContextMenuEvent Class
La clase `QContextMenuEvent` contiene parámetros que describen un evento del menú contextual. Más información...
| Encabezado: | #include <QContextMenuEvent> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Gui) target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake: | QT += gui |
| Heredado de: | QInputEvent |
- Lista de todos los miembros, incluidos los heredados
- Miembros obsoletos
- QContextMenuEvent forma parte de las clases de eventos.
Tipos públicos
| enum | Reason { Mouse, Keyboard, Other } |
Funciones públicas
| QContextMenuEvent(QContextMenuEvent::Reason reason, const QPoint &pos, const QPoint &globalPos, Qt::KeyboardModifiers modifiers = Qt::NoModifier) | |
| const QPoint & | globalPos() const |
| int | globalX() const |
| int | globalY() const |
| const QPoint & | pos() const |
| QContextMenuEvent::Reason | reason() const |
| int | x() const |
| int | y() const |
Funciones protegidas
| QContextMenuEvent(QContextMenuEvent &&) | |
| QContextMenuEvent & | operator=(QContextMenuEvent &&) |
| QContextMenuEvent & | operator=(const QContextMenuEvent &other) |
Descripción detallada
Se envía un evento de menú contextual cuando un usuario realiza una acción que debería abrir un menú contextual:
- al hacer clic con el botón derecho del ratón
- pulsar una tecla de menú específica del teclado (si el teclado dispone de una, como la tecla de menú de los teclados estándar de PC de 104 teclas)
- pulsar algún otro atajo de teclado (como «Ctrl+Retorno» por defecto en macOS 15 y versiones posteriores)
El menú contextual esperado debe contener elementos « actions » que sean relevantes para algún contenido dentro de la aplicación (el «contexto»). En Qt, el contexto es, como mínimo, el widget o Qt Quick Item concreto que recibe el QContextMenuEvent. Si hay una selección, probablemente debería tratarse como el contexto. El contexto puede refinarse aún más utilizando QContextMenuEvent::pos() para identificar con precisión el contenido dentro del widget, el elemento o la selección.
Los widgets pueden sobrescribir QWidget::contextMenuEvent() para gestionar este evento. Muchos widgets ya lo hacen y cuentan con menús contextuales útiles de forma predeterminada. Algunos widgets disponen de una función como createStandardContextMenu() para rellenar el conjunto predeterminado de acciones en un QMenu, que se puede personalizar aún más en tu subclase y, a continuación, mostrarse.
En Qt Quick, el evento se puede gestionar a través de la propiedad adjunta ContextMenu. Algunos controles QtQuick.Controls ya proporcionan menús contextuales de forma predeterminada.
A diferencia de la mayoría de los eventos sintéticos (como un « QMouseEvent », que solo se envía después de que no se haya aceptado un « QTouchEvent » o un « QTabletEvent »), el «QContextMenuEvent» se envía independientemente de si el evento original del ratón o del teclado ya se ha gestionado y de si « accepted » es verdadero. Esto se hace para adaptarse al patrón de la interfaz de usuario de Windows, en el que se seleccionan determinados elementos (iconos, elementos de dibujo o celdas en una vista de elementos) utilizando el botón derecho del ratón (haciendo clic o arrastrando) y, a continuación, aparece un menú contextual en cuanto se suelta el botón derecho del ratón. (Las acciones del menú están pensadas para aplicarse a la selección). Por lo tanto, en Windows el evento `QContextMenuEvent` se envía al soltar el ratón, mientras que en otras plataformas se envía al pulsarlo. Qt sigue el patrón « platform convention » de forma predeterminada.
También hay algunos controles « Qt Quick », como Pane, que aceptan eventos del ratón y, sin embargo, reciben un QContextMenuEvent tras pulsar o hacer clic con el ratón.
Si prefieres implementar el patrón de interfaz de usuario «pulsar-arrastrar-soltar» para abrir un menú contextual al pulsar y arrastrar el cursor sobre un elemento del menú para seleccionarlo al soltar, tendrás que hacerlo gestionando directamente QMouseEvents (sobrescribiendo virtual functions en las subclases de QWidget, o utilizando TapHandler para abrir un Menu en Qt Quick); y, en ese caso, el `QContextMenuEvent` resultará redundante cuando ` reason()` sea ` Mouse`. En ese caso, deberías llamar a ` ignore()` para el evento; pero aún así debes asegurarte de que el widget, el control personalizado o la aplicación puedan responder a un `QContextMenuEvent` que ` comes from ` el atajo de teclado específico de la plataforma.
Cuando un QContextMenuEvent es de tipo « ignored », Qt intenta transmitirlo a otros widgets y/o elementos situados bajo el « position » (que normalmente se calcula a partir de la posición del cursor).
Documentación del tipo de miembro
enum QContextMenuEvent::Reason
Esta enumeración describe el motivo por el que se envió el evento.
| Constante | Valor | Descripción |
|---|---|---|
QContextMenuEvent::Mouse | 0 | El ratón provocó el envío del evento. Normalmente, esto significa que se pulsó el botón derecho del ratón, aunque esto depende de la plataforma. |
QContextMenuEvent::Keyboard | 1 | El teclado provocó el envío de este evento. En Windows, esto significa que se pulsó el botón de menú. |
QContextMenuEvent::Other | 2 | El evento se envió por algún otro medio (es decir, ni por el ratón ni por el teclado). |
Documentación de la función miembro
QContextMenuEvent::QContextMenuEvent(QContextMenuEvent::Reason reason, const QPoint &pos, const QPoint &globalPos, Qt::KeyboardModifiers modifiers = Qt::NoModifier)
Crea un objeto de evento del menú contextual con el indicador del parámetro «accept» establecido en «false».
El parámetro « reason » debe ser « QContextMenuEvent::Mouse » o « QContextMenuEvent::Keyboard ».
El parámetro « pos » especifica la posición del ratón con respecto al widget receptor. « globalPos » indica la posición del ratón en coordenadas absolutas. « modifiers » contiene los modificadores del teclado.
[protected delete] QContextMenuEvent::QContextMenuEvent(QContextMenuEvent &&)
Crea una instancia de ` QContextMenuEvent`. Esta función se ha eliminado.
const QPoint &QContextMenuEvent::globalPos() const
Devuelve la posición global del puntero del ratón en el momento en que se produce el evento.
Véase también x(), y() y pos().
int QContextMenuEvent::globalX() const
Devuelve la posición x global del puntero del ratón en el momento del evento.
Véanse también globalY() y globalPos().
int QContextMenuEvent::globalY() const
Devuelve la posición global en el eje Y del puntero del ratón en el momento en que se produce el evento.
Véase también globalX() y globalPos().
const QPoint &QContextMenuEvent::pos() const
Devuelve la posición del puntero del ratón con respecto al widget que recibió el evento.
Nota: Si el evento « QContextMenuEvent » no procedía del botón derecho del ratón, el valor de « pos() » puede ser « null ».
Véase también x(), y() y globalPos().
QContextMenuEvent::Reason QContextMenuEvent::reason() const
Devuelve el motivo de este evento de contexto.
int QContextMenuEvent::x() const
Devuelve la posición x del puntero del ratón, en relación con el widget que recibió el evento.
int QContextMenuEvent::y() const
Devuelve la posición y del puntero del ratón, relativa al widget que recibió el evento.
[protected delete] QContextMenuEvent &QContextMenuEvent::operator=(QContextMenuEvent &&)
Asigna « other » a esta instancia de « QContextMenuEvent ». Esta función se elimina.
[noexcept protected default] QContextMenuEvent &QContextMenuEvent::operator=(const QContextMenuEvent &other)
Asigna por copia other a esta instancia de QContextMenuEvent.
© 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.