ContextMenuRequest QML Type
Una petición para mostrar un menú contextual. Más...
| Import Statement: | import QtWebEngine |
| Since: | QtWebEngine 1.4 |
Propiedades
- accepted : bool
- editFlags : flags
(since QtWebEngine 1.7) - isContentEditable : bool
- linkText : string
- linkUrl : url
- mediaFlags : flags
(since QtWebEngine 1.7) - mediaType : enumeration
- mediaUrl : url
- misspelledWord : string
- position : point
- selectedText : string
- spellCheckerSuggestions : stringlist
Descripción detallada
Una ContextMenuRequest se pasa como argumento de la señal WebEngineView::contextMenuRequested. Proporciona más información sobre el contexto de la solicitud. La propiedad position indica el origen de la solicitud.
La propiedad accepted de la petición indica si ésta debe ser gestionada por el código de usuario o si debe mostrarse el menú contextual por defecto.
El siguiente código utiliza un menú personalizado para gestionar la petición:
WebEngineView { id: view // ... onContextMenuRequested: function(request) { request.accepted = true; myMenu.x = request.x; myMenu.y = request.y; myMenu.trigger.connect(view.triggerWebAction); myMenu.popup(); } // ... }
Documentación de la propiedad
accepted : bool
Indica si la petición de menú contextual ha sido gestionada por el manejador de señal.
Si la propiedad es false después de que se haya ejecutado cualquier manejador de señales para WebEngineView::contextMenuRequested, se mostrará un menú contextual por defecto. Para evitarlo, establezca request.accepted a true.
El valor por defecto es false.
Nota: El contenido por defecto del menú contextual depende del elemento web para el que se haya generado la petición.
editFlags : flags [read-only, since QtWebEngine 1.7]
Las operaciones de edición disponibles en el contexto actual o CanDoNone si no hay acciones disponibles.
| Constante | Descripción |
|---|---|
ContextMenuRequest.CanUndo | Deshacer está disponible. |
ContextMenuRequest.CanRedo | Rehacer está disponible. |
ContextMenuRequest.CanCut | Cortar está disponible. |
ContextMenuRequest.CanCopy | Copiar disponible. |
ContextMenuRequest.CanPaste | Pegar está disponible. |
ContextMenuRequest.CanDelete | Borrar está disponible. |
ContextMenuRequest.CanSelectAll | Seleccionar todo está disponible. |
ContextMenuRequest.CanTranslate | Traducir. |
ContextMenuRequest.CanEditRichly | El contexto es ricamente editable. |
Esta propiedad se introdujo en QtWebEngine 1.7.
isContentEditable : bool [read-only]
Indica si el contenido web seleccionado es editable.
linkText : string [read-only]
El texto del enlace, si se ha solicitado el menú contextual para un enlace.
linkUrl : url [read-only]
La URL del enlace, si el contenido de la página web seleccionada es un enlace. No se garantiza que sea una URL válida.
mediaFlags : flags [read-only, since QtWebEngine 1.7]
Estado del elemento multimedia actual y operaciones disponibles. MediaNone si el contenido de la página web seleccionada no es un elemento multimedia.
| Constante | Descripción |
|---|---|
ContextMenuRequest.MediaInError | Se ha producido un error. |
ContextMenuRequest.MediaPaused | El medio está en pausa. |
ContextMenuRequest.MediaMuted | El contenido multimedia está silenciado. |
ContextMenuRequest.MediaLoop | El contenido puede reproducirse en bucle. |
ContextMenuRequest.MediaCanSave | El contenido se puede guardar. |
ContextMenuRequest.MediaHasAudio | El medio tiene audio. |
ContextMenuRequest.MediaCanToggleControls | Los medios pueden mostrar controles. |
ContextMenuRequest.MediaControls | Se muestran los controles del medio. |
ContextMenuRequest.MediaCanPrint | Los medios son imprimibles. |
ContextMenuRequest.MediaCanRotate | Los medios son giratorios. |
Esta propiedad se introdujo en QtWebEngine 1.7.
mediaType : enumeration [read-only]
El tipo del elemento multimedia, o MediaTypeNone si el contenido de la página web seleccionada no es un elemento multimedia.
| Constante | Descripción |
|---|---|
ContextMenuRequest.MediaTypeNone | No es un medio. |
ContextMenuRequest.MediaTypeImage | Una imagen. |
ContextMenuRequest.MediaTypeVideo | Un vídeo. |
ContextMenuRequest.MediaTypeAudio | Un elemento de audio. |
ContextMenuRequest.MediaTypeCanvas | Un lienzo. |
ContextMenuRequest.MediaTypeFile | Un archivo. |
ContextMenuRequest.MediaTypePlugin | Un plugin. |
mediaUrl : url [read-only]
La URL del contenido multimedia, si el contenido web seleccionado es un elemento multimedia.
misspelledWord : string [read-only]
Si el contexto es una palabra considerada mal escrita por el corrector ortográfico, devuelve la palabra mal escrita.
position : point [read-only]
Posición de la acción del usuario desde la que se origina la solicitud del menú contextual.
selectedText : string [read-only]
El texto seleccionado para el que se creó el menú contextual.
spellCheckerSuggestions : stringlist [read-only]
Si el contexto es una palabra considerada mal escrita por el corrector ortográfico, devuelve una lista de sustitutos sugeridos.
© 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.