QContextMenuEvent Class

Descripción Detallada

Un evento de menú contextual se envía cuando un usuario realiza una acción que debería abrir un menú contextual:

• pulsando el botón derecho del ratón
• pulsando una tecla de menú dedicada del teclado (si el teclado tiene una, como la tecla de menú en los teclados PC estándar de 104 teclas)
• pulsando algún otro atajo de teclado (como "Ctrl+Return" por defecto en macOS 15 y posteriores)

El menú contextual esperado debería contener actions que son relevantes para algún contenido dentro de la aplicación (el "contexto"). En Qt, el contexto es al menos el widget o Qt Quick Item particular que recibe el QContextMenuEvent. Si hay una selección, probablemente debería ser tratada como el contexto. El contexto se puede refinar aún más utilizando QContextMenuEvent::pos() para señalar el contenido dentro del widget, elemento o selección.

Los widgets pueden anular QWidget::contextMenuEvent() para manejar este evento. Muchos widgets ya lo hacen, y tienen útiles menús contextuales por defecto. Algunos widgets tienen una función como createStandardContextMenu() para rellenar el conjunto de acciones por defecto en un QMenu, que puede personalizarse más en tu subclase y luego mostrarse.

En Qt Quick, el evento puede ser manejado a través de la propiedad adjunta ContextMenu. Algunos controles de QtQuick.Controls ya proporcionan menús contextuales por defecto.

A diferencia de la mayoría de los eventos sintéticos (como un QMouseEvent que se envía sólo después de que un QTouchEvent o QTabletEvent no fue aceptado), QContextMenuEvent se envía independientemente de si el evento original de ratón o tecla ya fue manejado y accepted. Esto es para acomodar el patrón de Windows UI de seleccionar algún tipo de ítems (iconos, elementos de dibujo, o celdas en una Vista de Ítems) usando el botón derecho del ratón (haciendo click o arrastrando), y luego obtener un menú contextual tan pronto como se suelta el botón derecho del ratón. (Las acciones del menú se aplican a la selección.) Por lo tanto, en Windows el QContextMenuEvent se envía al soltar el ratón; mientras que en otras plataformas, se envía al pulsarlo. Qt sigue el platform convention por defecto.

También hay algunos Qt Quick Controls como Pane que aceptan eventos del ratón, y sin embargo reciben un QContextMenuEvent después de una pulsación o clic del ratón.

Si prefieres soportar el patrón UI pulsar-arrastrar-soltar para abrir un menú contextual al pulsar, y arrastrar sobre un elemento de menú para seleccionarlo al soltar, tendrás que hacerlo manejando QMouseEvents directamente (anulando virtual functions en subclases de QWidget, o usando TapHandler para abrir un Menu en Qt Quick); y entonces el QContextMenuEvent será redundante cuando el reason() sea Mouse. Deberías ignore() el evento en ese caso; pero aún así deberías asegurarte de que el widget, control personalizado o aplicación puede responder a un QContextMenuEvent que comes from el atajo de teclado específico de la plataforma.

Cuando un QContextMenuEvent es ignored, Qt intenta entregarlo a otros widgets y/o Items bajo el position (que normalmente se traduce desde la posición del cursor).