En esta página

ContextMenuRequest QML Type

Una petición para mostrar un menú contextual. Más...

Import Statement: import QtWebEngine
Since: QtWebEngine 1.4

Propiedades

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.

ConstanteDescripción
ContextMenuRequest.CanUndoDeshacer está disponible.
ContextMenuRequest.CanRedoRehacer está disponible.
ContextMenuRequest.CanCutCortar está disponible.
ContextMenuRequest.CanCopyCopiar disponible.
ContextMenuRequest.CanPastePegar está disponible.
ContextMenuRequest.CanDeleteBorrar está disponible.
ContextMenuRequest.CanSelectAllSeleccionar todo está disponible.
ContextMenuRequest.CanTranslateTraducir.
ContextMenuRequest.CanEditRichlyEl 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.

ConstanteDescripción
ContextMenuRequest.MediaInErrorSe ha producido un error.
ContextMenuRequest.MediaPausedEl medio está en pausa.
ContextMenuRequest.MediaMutedEl contenido multimedia está silenciado.
ContextMenuRequest.MediaLoopEl contenido puede reproducirse en bucle.
ContextMenuRequest.MediaCanSaveEl contenido se puede guardar.
ContextMenuRequest.MediaHasAudioEl medio tiene audio.
ContextMenuRequest.MediaCanToggleControlsLos medios pueden mostrar controles.
ContextMenuRequest.MediaControlsSe muestran los controles del medio.
ContextMenuRequest.MediaCanPrintLos medios son imprimibles.
ContextMenuRequest.MediaCanRotateLos 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.

ConstanteDescripción
ContextMenuRequest.MediaTypeNoneNo es un medio.
ContextMenuRequest.MediaTypeImageUna imagen.
ContextMenuRequest.MediaTypeVideoUn vídeo.
ContextMenuRequest.MediaTypeAudioUn elemento de audio.
ContextMenuRequest.MediaTypeCanvasUn lienzo.
ContextMenuRequest.MediaTypeFileUn archivo.
ContextMenuRequest.MediaTypePluginUn 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.