Sur cette page

ContextMenuRequest QML Type

Demande d'affichage d'un menu contextuel. Plus d'informations...

Import Statement: import QtWebEngine
Since: QtWebEngine 1.4

Propriétés

Description détaillée

Un ContextMenuRequest est transmis en tant qu'argument du signal WebEngineView::contextMenuRequested. Il fournit des informations supplémentaires sur le contexte de la demande. La propriété position indique l'origine de la demande.

La propriété accepted de la demande indique si la demande est traitée par le code utilisateur ou si le menu contextuel par défaut doit être affiché.

Le code suivant utilise un menu personnalisé pour traiter la demande :

WebEngineView {
    id: view
    // ...
    onContextMenuRequested: function(request) {
        request.accepted = true;
        myMenu.x = request.x;
        myMenu.y = request.y;
        myMenu.trigger.connect(view.triggerWebAction);
        myMenu.popup();
    }
    // ...
}

Propriété Documentation

accepted : bool

Indique si la demande de menu contextuel a été traitée par le gestionnaire de signal.

Si la propriété est false après l'exécution de tout gestionnaire de signal pour WebEngineView::contextMenuRequested, un menu contextuel par défaut sera affiché. Pour éviter cela, définissez request.accepted comme étant true.

La valeur par défaut est false.

Remarque : le contenu par défaut du menu contextuel dépend de l'élément web pour lequel la demande a été générée.

editFlags : flags [read-only, since QtWebEngine 1.7]

Les opérations d'édition disponibles dans le contexte actuel ou CanDoNone si aucune action n'est disponible.

ConstanteDescription
ContextMenuRequest.CanUndoL'annulation est disponible.
ContextMenuRequest.CanRedoRétablir est disponible.
ContextMenuRequest.CanCutCouper est disponible.
ContextMenuRequest.CanCopyCopier est disponible.
ContextMenuRequest.CanPasteColler est disponible.
ContextMenuRequest.CanDeleteLa fonction Supprimer est disponible.
ContextMenuRequest.CanSelectAllSélectionner tout est disponible.
ContextMenuRequest.CanTranslateTraduire est disponible.
ContextMenuRequest.CanEditRichlyLe contexte est richement modifiable.

Cette propriété a été introduite dans QtWebEngine 1.7.

isContentEditable : bool [read-only]

Indique si le contenu web sélectionné est modifiable.

linkText : string [read-only]

Le texte du lien, si le menu contextuel a été demandé pour un lien.

linkUrl : url [read-only]

L'URL du lien, si le contenu de la page web sélectionnée est un lien. Il n'est pas garanti qu'il s'agisse d'une URL valide.

mediaFlags : flags [read-only, since QtWebEngine 1.7]

Statut de l'élément multimédia actuel et opérations disponibles. MediaNone si le contenu de la page web sélectionnée n'est pas un élément multimédia.

ConstanteDescription de l'erreur
ContextMenuRequest.MediaInErrorUne erreur s'est produite.
ContextMenuRequest.MediaPausedLe média est en pause.
ContextMenuRequest.MediaMutedLe média est en sourdine.
ContextMenuRequest.MediaLoopLe média peut être mis en boucle.
ContextMenuRequest.MediaCanSaveLe média peut être sauvegardé.
ContextMenuRequest.MediaHasAudioLe média a du son.
ContextMenuRequest.MediaCanToggleControlsLe média peut afficher des commandes.
ContextMenuRequest.MediaControlsLes commandes du média sont affichées.
ContextMenuRequest.MediaCanPrintLe média est imprimable.
ContextMenuRequest.MediaCanRotateLe média est rotatif.

Cette propriété a été introduite dans QtWebEngine 1.7.

mediaType : enumeration [read-only]

Le type de l'élément multimédia, ou MediaTypeNone si le contenu de la page web sélectionnée n'est pas un élément multimédia.

ConstanteDescription
ContextMenuRequest.MediaTypeNonePas un média.
ContextMenuRequest.MediaTypeImageUne image.
ContextMenuRequest.MediaTypeVideoUne vidéo.
ContextMenuRequest.MediaTypeAudioUn élément audio.
ContextMenuRequest.MediaTypeCanvasUne toile.
ContextMenuRequest.MediaTypeFileUn fichier.
ContextMenuRequest.MediaTypePluginUn plugin.

mediaUrl : url [read-only]

L'URL du média, si le contenu web sélectionné est un élément média.

misspelledWord : string [read-only]

Si le contexte est un mot considéré comme mal orthographié par le correcteur orthographique, il renvoie le mot mal orthographié.

position : point [read-only]

Position de l'action de l'utilisateur à l'origine de la demande de menu contextuel.

selectedText : string [read-only]

Le texte sélectionné pour lequel le menu contextuel a été créé.

spellCheckerSuggestions : stringlist [read-only]

Si le contexte est un mot considéré comme mal orthographié par le correcteur d'orthographe, il renvoie une liste de suggestions de remplacement.

© 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.